Cloud Service Roles - Get

Serviço:

Compute

Versão da API:

2024-11-04

Obtém uma função de um serviço de nuvem.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/roles/{roleName}?api-version=2024-11-04

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
cloudServiceName	path	True	string	Nome do serviço de nuvem.
resourceGroupName	path	True	string	Nome do grupo de recursos.
roleName	path	True	string	Nome da função.
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	CloudServiceRole	OKEY
Other Status Codes	CloudError	Erro

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

Get Cloud Service Role

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/roles/{role-name}?api-version=2024-11-04

Resposta de exemplo

Código de status:

200

{
  "name": "{role-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/roles/{role-name}",
  "type": "Microsoft.Compute/cloudServices/roles",
  "location": "eastus2euap",
  "sku": {
    "name": "Standard_D1_v2",
    "tier": "Standard",
    "capacity": 2
  },
  "properties": {
    "uniqueId": "b03bc269-766b-4921-b91a-7dffaae4d03b:{role-name}"
  }
}

Definições

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
CloudError	Uma resposta de erro do serviço Compute.
CloudServiceRole	Descreve uma função do serviço de nuvem.
CloudServiceRoleProperties	As propriedades da função de serviço de nuvem.
CloudServiceRoleSku	Descreve o sku da função de serviço de nuvem.
InnerError	Detalhes do erro interno.

ApiError

Objeto

Erro de API.

Nome	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	InnerError	O erro interno da API
message	string	A mensagem de erro.
target	string	O destino do erro específico.

ApiErrorBase

Objeto

Base de erros da API.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O destino do erro específico.

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	Tipo	Description
error	ApiError	Erro de API.

CloudServiceRole

Objeto

Descreve uma função do serviço de nuvem.

Nome	Tipo	Description
id	string	ID do recurso
location	string	Local do recurso
name	string	Nome do recurso
properties	CloudServiceRoleProperties	As propriedades da função de serviço de nuvem.
sku	CloudServiceRoleSku	Descreve o sku da função de serviço de nuvem.
type	string	Tipo de recurso

CloudServiceRoleProperties

Objeto

As propriedades da função de serviço de nuvem.

Nome	Tipo	Description
uniqueId	string	Especifica a ID que identifica exclusivamente uma função de serviço de nuvem.

CloudServiceRoleSku

Objeto

Descreve o sku da função de serviço de nuvem.

Nome	Tipo	Description
capacity	integer (int64)	Especifica o número de instâncias de função no serviço de nuvem.
name	string	O nome do sku. OBSERVAÇÃO: se o novo SKU não tiver suporte no hardware em que o serviço de nuvem está atualmente, você precisará excluir e recriar o serviço de nuvem ou voltar para o sku antigo.
tier	string	Especifica a camada do serviço de nuvem. Valores possíveis são Standard Basic

InnerError

Objeto

Detalhes do erro interno.

Nome	Tipo	Description
errordetail	string	A mensagem de erro interna ou o despejo de exceção.
exceptiontype	string	O tipo de exceção.