az apim api schema
Administre los esquemas de api de Azure API Management.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az apim api schema create |
Cree un esquema de API Management API. |
Core | GA |
| az apim api schema delete |
Elimine un esquema de API Management API. |
Core | GA |
| az apim api schema get-etag |
Obtenga etag de un esquema de API Management API. |
Core | GA |
| az apim api schema list |
Enumerar los esquemas de API Management API. |
Core | GA |
| az apim api schema show |
Mostrar detalles de un esquema de API Management API. |
Core | GA |
| az apim api schema wait |
Coloque la CLI en un estado de espera hasta que se cumpla una condición de un esquema de APIm. |
Core | GA |
az apim api schema create
Cree un esquema de API Management API.
az apim api schema create --api-id
--resource-group
--schema-id
--schema-type
--service-name
[--no-wait]
[--resource-type]
[--schema-content]
[--schema-name]
[--schema-path]
Ejemplos
Cree un esquema de API.
az apim api schema create --service-name MyApim -g MyResourceGroup --api-id MyApi --schema-id schemaId --schema-type schemaType --schema-path schemaFilePath
Parámetros requeridos
Nombre único de la API para la que se debe crear el esquema.
Identificador de revisión de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | API Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre único del esquema de API que se va a crear.
Identificador de esquema. Debe ser único en la instancia actual del servicio API Management.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Tipo de esquema (por ejemplo, application/json, application/vnd.ms-azure-apim.graphql.schema).
Debe ser un tipo de medio válido usado en un encabezado Content-Type tal como se define en RFC 2616. Tipo de medio del documento de esquema.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Nombre de la instancia del servicio API Management.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
No espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Cadena de escape json que define el documento que representa el esquema.
Especifique --schema-path o --schema-content no ambos.
Nombre del recurso de esquema.
Ruta de acceso de archivo especificada para importar el esquema de la API.
Especifique --schema-path o --schema-content no ambos.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az apim api schema delete
Elimine un esquema de API Management API.
az apim api schema delete --api-id
--resource-group
--schema-id
--service-name
[--if-match]
[--no-wait]
[--yes]
Ejemplos
eliminar un esquema de API.
az apim api schema delete --service-name MyApim -g MyResourceGroup --api-id MyApi --schema-id schemaId
Parámetros requeridos
Identificador de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | API Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Identificador de esquema. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Nombre de la instancia del servicio API Management.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
ETag de la entidad.
No espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az apim api schema get-etag
Obtenga etag de un esquema de API Management API.
az apim api schema get-etag --api-id
--resource-group
--schema-id
--service-name
Ejemplos
obtiene una etiqueta de entidad de esquema.
az apim api schema get-etag --service-name MyApim -g MyResourceGroup --api-id MyApi --schema-id schemaId
Parámetros requeridos
Identificador de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | API Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Identificador de esquema. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Nombre de la instancia del servicio API Management.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az apim api schema list
Enumerar los esquemas de API Management API.
az apim api schema list --api-id
--resource-group
--service-name
[--filter-display-name]
[--skip]
[--top]
Ejemplos
Obtenga la lista de esquemas asociados a un identificador de API.
az apim api schema list --service-name MyApim -g MyResourceGroup --api-id MyApi
Parámetros requeridos
Identificador de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | API Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre de la instancia del servicio API Management.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Filtrar las API por displayName.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Número de registros que se van a omitir.
Número de registros que se van a devolver.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az apim api schema show
Mostrar detalles de un esquema de API Management API.
az apim api schema show --api-id
--resource-group
--schema-id
--service-name
Ejemplos
Obtener un esquema de API.
az apim api schema show --service-name MyApim -g MyResourceGroup --api-id MyApi --schema-id schemaId
Parámetros requeridos
Identificador de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | API Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Identificador de esquema. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schema Arguments |
Nombre de la instancia del servicio API Management.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az apim api schema wait
Coloque la CLI en un estado de espera hasta que se cumpla una condición de un esquema de APIm.
az apim api schema wait --api-id
--name
--resource-group
--schema-id
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Ejemplos
Coloque la CLI en un estado de espera hasta que se cumpla una condición de un esquema de APIm.
az apim api schema wait --created --api-id MyApi --name MyApim --schema-id schemaId -g MyResourceGroup
Parámetros requeridos
Identificador de revisión de API. Debe ser único en la instancia actual del servicio API Management. La revisión no actual tiene ; rev=n como sufijo donde n es el número de revisión. Required.
Nombre de la instancia del servicio api management.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Identificador de identificador de esquema. Debe ser único en la instancia actual del servicio API Management. Required.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Espere hasta que se cree con "provisioningState" en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
Espere hasta que se elimine.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Espere hasta que exista el recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Intervalo de sondeo en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 30 |
Espera máxima en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 3600 |
Espere hasta que se actualice con provisioningState en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |