Container Services - Get

Obtém as propriedades do serviço de contêiner especificado na assinatura e no grupo de recursos especificados. A operação retorna as propriedades, 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/{containerServiceName}?api-version=2017-01-31

Parâmetros de URI

Name In Required Type Description
containerServiceName
path True
  • string

O nome do serviço de contêiner na assinatura e no grupo de recursos especificados.

resourceGroupName
path True
  • string

O nome do grupo de recursos.

subscriptionId
path True
  • string

Credenciais de assinatura que identificam exclusivamente Microsoft Azure assinatura. 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

Name Type Description
200 OK

OK

Segurança

azure_auth

Fluxo de OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Get Container Service

Sample Request

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

Sample Response

{
  "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/"
      }
    }
  }
}

Definições

ContainerService

Serviço de contêiner.

ContainerServiceAgentPoolProfile

Perfil do pool de agente de serviço de contêiner.

ContainerServiceCustomProfile

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

ContainerServiceDiagnosticsProfile
ContainerServiceLinuxProfile

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

ContainerServiceMasterProfile

Perfil do mestre de 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 do 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 usar para manipular as APIs do Azure.

ContainerServiceSshConfiguration

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

ContainerServiceSshPublicKey

Contém informações sobre os 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

Serviço de contêiner.

Name Type Description
id
  • string

ID do recurso

location
  • string

Localização do recurso

name
  • string

Nome do recurso

properties.agentPoolProfiles

Propriedades do pool de agentes.

properties.customProfile

Propriedades para clusters personalizados.

properties.diagnosticsProfile

Propriedades do agente de diagnóstico.

properties.linuxProfile

Propriedades de VMs do Linux.

properties.masterProfile

Propriedades de agentes mestres.

properties.orchestratorProfile

Propriedades do orquestrador.

properties.provisioningState
  • string

o estado atual de implantação ou provisionamento, que aparece apenas na resposta.

properties.servicePrincipalProfile

Propriedades para entidades de serviço de cluster.

properties.windowsProfile

Propriedades de VMs do Windows.

tags
  • object

Marcações de recursos

type
  • string

Tipo de recurso

ContainerServiceAgentPoolProfile

Perfil do pool de agente de serviço de contêiner.

Name Type Description
count
  • integer

Número de agentes (VMs) para hospedar contêineres do Docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusivo). 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

Tamanho das VMs do agente.

ContainerServiceCustomProfile

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

Name Type Description
orchestrator
  • string

O nome do orquestrador personalizado a ser usado.

ContainerServiceDiagnosticsProfile

Name Type Description
vmDiagnostics

Perfil do agente de diagnóstico da VM do serviço de contêiner.

ContainerServiceLinuxProfile

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

Name Type Description
adminUsername
  • string

O nome de usuário do administrador a ser usado para VMs do Linux.

ssh

A configuração da chave SSH para VMs do Linux.

ContainerServiceMasterProfile

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

Name Type Description
count enum:
  • 1
  • 3
  • 5

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 o mestre.

fqdn
  • string

FQDN do mestre.

ContainerServiceOrchestratorProfile

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

Name Type Description
orchestratorType

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

ContainerServiceOrchestratorTypes

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

Name Type Description
Custom
  • string
DCOS
  • string
Kubernetes
  • string
Swarm
  • string

ContainerServiceServicePrincipalProfile

Informações sobre uma identidade de entidade de serviço para o cluster usar para manipular as APIs do Azure.

Name Type Description
clientId
  • string

A ID da entidade de serviço.

secret
  • string

A senha secreta associada à entidade de serviço.

ContainerServiceSshConfiguration

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

Name Type Description
publicKeys

a lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux.

ContainerServiceSshPublicKey

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

Name Type Description
keyData
  • string

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

ContainerServiceVMDiagnostics

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

Name Type Description
enabled
  • boolean

Se o agente de diagnóstico da VM está provisionado na VM.

storageUri
  • string

O URI da conta de armazenamento em que o diagnóstico é armazenado.

ContainerServiceVMSizeTypes

Tamanho das VMs do agente.

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

ContainerServiceWindowsProfile

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

Name Type Description
adminPassword
  • string

A senha de administrador a ser usada para VMs do Windows.

adminUsername
  • string

O nome de usuário do administrador a ser usado para VMs do Windows.