Container Services - List By Resource Group

Referência

Serviço:: Compute

Versão da API:: 2017-01-31

Obtém uma lista de serviços de contêiner no grupo de recursos especificado.
Obtém uma lista de serviços de contêiner na assinatura e no grupo de recursos especificados. A operação retorna propriedades de cada serviço de contêiner, incluindo estado, orquestrador, número de mestres e agentes e FQDNs de mestres e agentes.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/containerServices?api-version=2017-01-31

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Respostas

Nome	Tipo	Description
200 OK	ContainerServiceListResult	OKEY

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List Container Services by Resource Group

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/containerServices?api-version=2017-01-31

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "type": "Microsoft.ContainerService/ContainerServices",
      "location": "location1",
      "id": "/subscriptions/subid1/resourceGroups/RG1/providers/Microsoft.ContainerService/containerServices/acs1",
      "name": "acs1",
      "properties": {
        "provisioningState": "Succeeded",
        "orchestratorProfile": {
          "orchestratorType": "DCOS"
        },
        "masterProfile": {
          "count": 1,
          "dnsPrefix": "acs1-rg1-e240e5mgmt",
          "fqdn": "acs1-rg1-e240e5mgmt.location1.cloudapp.azure.com"
        },
        "agentPoolProfiles": [
          {
            "name": "agentpool0",
            "count": 3,
            "vmSize": "Standard_D2_v2",
            "dnsPrefix": "acs1-rg1-e240e5agent",
            "fqdn": "acs1-rg1-e240e5agent.location1.cloudapp.azure.com"
          }
        ],
        "linuxProfile": {
          "ssh": {
            "publicKeys": [
              {
                "keyData": "ssh-rsa AAAAB3NzaC1y...+0vNzo1FAdQ== user@hostname.local\n"
              }
            ]
          },
          "adminUsername": "azureuser"
        },
        "diagnosticsProfile": {
          "vmDiagnostics": {
            "enabled": true,
            "storageUri": "https://mjwjtrv73stvgdiag0.blob.core.windows.net/"
          }
        }
      }
    },
    {
      "type": "Microsoft.ContainerService/ContainerServices",
      "location": "location1",
      "id": "/subscriptions/subid1/resourceGroups/RG1/providers/Microsoft.ContainerService/containerServices/acs2",
      "name": "acs2",
      "properties": {
        "provisioningState": "Creating",
        "orchestratorProfile": {
          "orchestratorType": "DCOS"
        },
        "masterProfile": {
          "count": 1,
          "dnsPrefix": "acs2-rg1-e240e5mgmt"
        },
        "agentPoolProfiles": [
          {
            "name": "agentpool0",
            "count": 3,
            "vmSize": "Standard_D2_v2",
            "dnsPrefix": "acs2-rg1-e240e5agent"
          }
        ],
        "linuxProfile": {
          "ssh": {
            "publicKeys": [
              {
                "keyData": "ssh-rsa AAAAB3NzaC1y...+0vNzo1FAdQ== user@hostname.local\n"
              }
            ]
          },
          "adminUsername": "azureuser"
        },
        "diagnosticsProfile": {
          "vmDiagnostics": {
            "enabled": true
          }
        }
      }
    }
  ]
}

Definições

Nome	Description
ContainerService	Serviço de contêiner.
ContainerServiceAgentPoolProfile	Perfil para o pool de agentes do serviço de contêiner.
ContainerServiceCustomProfile	Propriedades para configurar um cluster de serviço de contêiner personalizado.
ContainerServiceDiagnosticsProfile
ContainerServiceLinuxProfile	Perfil para VMs linux no cluster de serviço de contêiner.
ContainerServiceListResult	A resposta da operação Listar Serviços de Contêiner.
ContainerServiceMasterProfile	Perfil do mestre do serviço de contêiner.
ContainerServiceOrchestratorProfile	Perfil do orquestrador de serviço de contêiner.
ContainerServiceOrchestratorTypes	O orquestrador a ser usado para gerenciar recursos de cluster de serviço de contêiner. Os valores válidos são Swarm, DCOS e Custom.
ContainerServiceServicePrincipalProfile	Informações sobre uma identidade de entidade de serviço para o cluster a ser usado para manipular APIs do Azure.
ContainerServiceSshConfiguration	Configuração de SSH para VMs baseadas em Linux em execução no Azure.
ContainerServiceSshPublicKey	Contém informações sobre dados de chave pública do certificado SSH.
ContainerServiceVMDiagnostics	Perfil para diagnóstico nas VMs do serviço de contêiner.
ContainerServiceVMSizeTypes	Tamanho das VMs do agente.
ContainerServiceWindowsProfile	Perfil para VMs do Windows no cluster do serviço de contêiner.

ContainerService

Objeto

Serviço de contêiner.

Nome	Tipo	Description
id	string	ID do recurso
location	string	Local do recurso
name	string	Nome do recurso
properties.agentPoolProfiles	ContainerServiceAgentPoolProfile[]	Propriedades do pool de agentes.
properties.customProfile	ContainerServiceCustomProfile	Propriedades para clusters personalizados.
properties.diagnosticsProfile	ContainerServiceDiagnosticsProfile	Propriedades do agente de diagnóstico.
properties.linuxProfile	ContainerServiceLinuxProfile	Propriedades de VMs do Linux.
properties.masterProfile	ContainerServiceMasterProfile	Propriedades de agentes mestres.
properties.orchestratorProfile	ContainerServiceOrchestratorProfile	Propriedades do orquestrador.
properties.provisioningState	string	o estado de implantação ou provisionamento atual, que aparece apenas na resposta.
properties.servicePrincipalProfile	ContainerServiceServicePrincipalProfile	Propriedades para entidades de serviço de cluster.
properties.windowsProfile	ContainerServiceWindowsProfile	Propriedades de VMs do Windows.
tags	object	Etiquetas de recursos
type	string	Tipo de recurso

ContainerServiceAgentPoolProfile

Objeto

Perfil para o pool de agentes do serviço de contêiner.

Nome	Tipo	Valor padrão	Description
count	integer (int32) minimum: 1 maximum: 100	1	Número de agentes (VMs) para hospedar contêineres do Docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1.
dnsPrefix	string		Prefixo DNS a ser usado para criar o FQDN para o pool de agentes.
fqdn	string		FQDN para o pool de agentes.
name	string		Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos.
vmSize	ContainerServiceVMSizeTypes		Tamanho das VMs do agente.

ContainerServiceCustomProfile

Objeto

Propriedades para configurar um cluster de serviço de contêiner personalizado.

Nome	Tipo	Description
orchestrator	string	O nome do orquestrador personalizado a ser usado.

ContainerServiceDiagnosticsProfile

Objeto

Nome	Tipo	Description
vmDiagnostics	ContainerServiceVMDiagnostics	Perfil do agente de diagnóstico de VM do serviço de contêiner.

ContainerServiceLinuxProfile

Objeto

Perfil para VMs linux no cluster de serviço de contêiner.

Nome	Tipo	Description
adminUsername	string pattern: ^[a-z][a-z0-9_-]*$	O nome de usuário do administrador a ser usado para VMs linux.
ssh	ContainerServiceSshConfiguration	A configuração de chave ssh para VMs do Linux.

ContainerServiceListResult

Objeto

A resposta da operação Listar Serviços de Contêiner.

Nome	Tipo	Description
nextLink	string	A URL para obter o próximo conjunto de resultados do serviço de contêiner.
value	ContainerService[]	a lista de serviços de contêiner.

ContainerServiceMasterProfile

Objeto

Perfil do mestre do serviço de contêiner.

Nome	Tipo	Valor padrão	Description
count	enum: 1 (int32) 3 (int32) 5 (int32)	1	Número de mestres (VMs) no cluster do serviço de contêiner. Os valores permitidos são 1, 3 e 5. O valor padrão é 1.
dnsPrefix	string		Prefixo DNS a ser usado para criar o FQDN para mestre.
fqdn	string		FQDN para o mestre.

ContainerServiceOrchestratorProfile

Objeto

Perfil do orquestrador de serviço de contêiner.

Nome	Tipo	Description
orchestratorType	ContainerServiceOrchestratorTypes	O orquestrador a ser usado para gerenciar recursos de cluster de serviço de contêiner. Os valores válidos são Swarm, DCOS e Custom.

ContainerServiceOrchestratorTypes

Enumeração

O orquestrador a ser usado para gerenciar recursos de cluster de serviço de contêiner. Os valores válidos são Swarm, DCOS e Custom.

Valor	Description
Custom
DCOS
Kubernetes
Swarm

ContainerServiceServicePrincipalProfile

Objeto

Informações sobre uma identidade de entidade de serviço para o cluster a ser usado para manipular APIs do Azure.

Nome	Tipo	Description
clientId	string	A ID da entidade de serviço.
secret	string	A senha secreta associada à entidade de serviço.

ContainerServiceSshConfiguration

Objeto

Configuração de SSH para VMs baseadas em Linux em execução no Azure.

Nome	Tipo	Description
publicKeys	ContainerServiceSshPublicKey[]	a lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux.

ContainerServiceSshPublicKey

Objeto

Contém informações sobre dados de chave pública do certificado SSH.

Nome	Tipo	Description
keyData	string	Chave pública de certificado usada para autenticar com VMs por meio do SSH. O certificado deve estar no formato PEM com ou sem cabeçalhos.

ContainerServiceVMDiagnostics

Objeto

Perfil para diagnóstico nas VMs do serviço de contêiner.

Nome	Tipo	Description
enabled	boolean	Se o agente de diagnóstico de VM é provisionado na VM.
storageUri	string	O URI da conta de armazenamento em que os diagnósticos são armazenados.

ContainerServiceVMSizeTypes

Enumeração

Tamanho das VMs do agente.

Valor	Description
Standard_A0
Standard_A1
Standard_A10
Standard_A11
Standard_A2
Standard_A3
Standard_A4
Standard_A5
Standard_A6
Standard_A7
Standard_A8
Standard_A9
Standard_D1
Standard_D11
Standard_D11_v2
Standard_D12
Standard_D12_v2
Standard_D13
Standard_D13_v2
Standard_D14
Standard_D14_v2
Standard_D1_v2
Standard_D2
Standard_D2_v2
Standard_D3
Standard_D3_v2
Standard_D4
Standard_D4_v2
Standard_D5_v2
Standard_DS1
Standard_DS11
Standard_DS12
Standard_DS13
Standard_DS14
Standard_DS2
Standard_DS3
Standard_DS4
Standard_G1
Standard_G2
Standard_G3
Standard_G4
Standard_G5
Standard_GS1
Standard_GS2
Standard_GS3
Standard_GS4
Standard_GS5

ContainerServiceWindowsProfile

Objeto

Perfil para VMs do Windows no cluster do serviço de contêiner.

Nome	Tipo	Description
adminPassword	string pattern: ^(?=.[a-z])(?=.[A-Z])(?=.[!@#$%\^&\])[a-zA-Z\d!@#$%\^&\*]{12,123}$	A senha de administrador a ser usada para VMs do Windows.
adminUsername	string pattern: ^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$	O nome de usuário do administrador a ser usado para VMs do Windows.

Compartilhar via

Container Services - List By Resource Group

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

List Container Services by Resource Group

Solicitação de exemplo

Resposta de exemplo

Definições

ContainerService

ContainerServiceAgentPoolProfile

ContainerServiceCustomProfile

ContainerServiceDiagnosticsProfile

ContainerServiceLinuxProfile

ContainerServiceListResult

ContainerServiceMasterProfile

ContainerServiceOrchestratorProfile

ContainerServiceOrchestratorTypes

ContainerServiceServicePrincipalProfile

ContainerServiceSshConfiguration

ContainerServiceSshPublicKey

ContainerServiceVMDiagnostics

ContainerServiceVMSizeTypes

ContainerServiceWindowsProfile