Managed Clusters - Run Command

Servicio:

AKS

Versión de la API:

2021-05-01

Envía un comando para ejecutarse en el clúster administrado.
AKS creará un pod para ejecutar el comando. Esto es principalmente útil para los clústeres privados. Para obtener más información, consulte comando de ejecución de AKS.

HTTP

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/runCommand?api-version=2021-05-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos.
resourceName	path	True	string	Nombre del recurso de clúster administrado. Patrón de Regex: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version	query	True	string	Versión de api de cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
command	True	string	Comando que se va a ejecutar.
clusterToken		string	AuthToken emitido para la aplicación de servidor de AKS AAD.
context		string	Un archivo ZIP codificado en base64 que contiene los archivos necesarios para el comando.

Respuestas

Nombre	Tipo	Description
200 OK	RunCommandResult	el comando finalizó con el patrón asincrónico, el seguimiento por encabezado de ubicación. !!! esto es solo para autorest, nunca obtendrá 200 de esta API !!
202 Accepted		Aceptado
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación. Si el clúster no existe, se devuelve 404 (no encontrado).

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

submitNewCommand

Solicitud de ejemplo

HTTP

HTTP

POST https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/runCommand?api-version=2021-05-01

{
  "command": "kubectl apply -f ns.yaml",
  "context": "",
  "clusterToken": ""
}

Respuesta de muestra

status code:

202

HTTP

location: https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/commandResults/0e9872e6629349dc865e27ee6f8bab2d?api-version=2021-05-01

status code:

200

JSON

{
  "id": "def7b3ea71bd4f7e9d226ddbc0f00ad9",
  "properties": {
    "provisioningState": "succeeded",
    "exitCode": 0,
    "startedAt": "2021-02-17T00:28:20Z",
    "finishedAt": "2021-02-17T00:28:33Z",
    "logs": "namespace dummy created"
  }
}

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio contenedor.
CloudErrorBody	Respuesta de error del servicio contenedor.
RunCommandRequest	Una solicitud de comando de ejecución
RunCommandResult	ejecutar el resultado del comando.

CloudError

Respuesta de error del servicio contenedor.

Nombre	Tipo	Description
error	CloudErrorBody	Detalles sobre el error.

CloudErrorBody

Respuesta de error del servicio contenedor.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

RunCommandRequest

Una solicitud de comando de ejecución

Nombre	Tipo	Description
clusterToken	string	AuthToken emitido para la aplicación de servidor de AKS AAD.
command	string	Comando que se va a ejecutar.
context	string	Un archivo ZIP codificado en base64 que contiene los archivos necesarios para el comando.

RunCommandResult

ejecutar el resultado del comando.

Nombre	Tipo	Description
id	string	Identificador del comando.
properties.exitCode	integer	Código de salida del comando
properties.finishedAt	string	Hora a la que finalizó el comando.
properties.logs	string	Salida del comando.
properties.provisioningState	string	estado de aprovisionamiento
properties.reason	string	Explicación de por qué provisioningState está establecido en error (si es así).
properties.startedAt	string	Hora a la que se inició el comando.