Batch Account - Get
Obtém informações sobre a conta do Lote especificada.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-07-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Um nome para a conta Batch que deve ser única dentro da região. Os nomes das contas do lote devem ter entre 3 e 24 caracteres de extensão e devem usar apenas números e letras minúsculas. Esse nome é usado como parte do nome DNS usado para acessar o serviço Batch na região onde a conta é criada. Por exemplo: |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A operação do Azure foi concluída com êxito. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo do 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
|
Batch |
|
Private |
BatchAccountGet
Solicitação de exemplo
Resposta de exemplo
{
"name": "sampleacct",
"type": "Microsoft.Batch/batchAccounts",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"identity": {
"type": "None"
},
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"lastKeySync": "2016-03-10T23:48:38.9878479Z",
"storageAccountId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
},
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolAllocationMode": "BatchService",
"poolQuota": 20,
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled"
}
}
PrivateBatchAccountGet
Solicitação de exemplo
Resposta de exemplo
{
"name": "sampleacct",
"type": "Microsoft.Batch/batchAccounts",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"lastKeySync": "2016-03-10T23:48:38.9878479Z",
"storageAccountId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
},
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolAllocationMode": "BatchService",
"poolQuota": 20,
"privateEndpointConnections": [
{
"name": "testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"type": "Microsoft.Batch/batchAccounts/privateEndpointConnections",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/privateEndpointConnections/testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Network/privateEndpoints/testprivateEndpoint"
},
"privateLinkServiceConnectionState": {
"description": "Approved by xyz.abc@company.com",
"status": "Approved"
}
}
}
],
"provisioningState": "Succeeded",
"publicNetworkAccess": "Disabled"
}
}
Definições
| Nome | Description |
|---|---|
|
Authentication |
O modo de autenticação da conta do Lote. |
|
Auto |
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático. |
|
Auto |
Contém informações sobre a conta de armazenamento automático associada a uma conta do Lote. |
|
Batch |
Contém informações sobre uma conta do Lote do Azure. |
|
Batch |
A identidade da conta do Lote, se configurada. Isso é usado quando o usuário especifica 'Microsoft.KeyVault' como a configuração de criptografia da conta do Lote ou quando |
|
Cloud |
Uma resposta de erro do serviço do Lote. |
|
Cloud |
Uma resposta de erro do serviço do Lote. |
|
Compute |
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará. |
|
created |
O tipo de identidade que criou o recurso. |
|
Encryption |
Configura como os dados do cliente são criptografados dentro da conta do Lote. Por padrão, as contas são criptografadas usando uma chave gerenciada da Microsoft. Para controle adicional, uma chave gerenciada pelo cliente pode ser usada. |
|
Endpoint |
Ação padrão para acesso ao ponto de extremidade. Ela só é aplicável quando publicNetworkAccess está habilitado. |
|
Endpoint |
Perfil de acesso à rede para o ponto de extremidade do Lote. |
| IPRule |
Regra para filtrar o endereço IP do cliente. |
|
IPRule |
A ação quando o endereço IP do cliente é correspondido. |
|
Key |
Tipo da origem da chave. |
|
Key |
Configuração do KeyVault ao usar um KeySource de criptografia do Microsoft.KeyVault. |
|
Key |
Identifica o cofre de chaves do Azure associado a uma conta do Lote. |
|
Network |
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade. |
|
Pool |
O modo de alocação para criar pools na conta do Lote. |
|
Private |
O ponto de extremidade privado da conexão de ponto de extremidade privado. |
|
Private |
Contém informações sobre um recurso de link privado. |
|
Private |
O estado de provisionamento da conexão de ponto de extremidade privado. |
|
Private |
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado |
|
Private |
O status da conexão de ponto de extremidade privado do Lote |
|
Provisioning |
O estado provisionado do recurso |
|
Public |
O tipo de interface de rede para acessar o serviço do Lote do Azure e as operações de conta do Lote. |
|
Resource |
O tipo de identidade usado para a conta do Lote. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
|
User |
A lista de identidades de usuário associadas. |
|
Virtual |
Uma família de VMs e sua cota de núcleo associada para a conta do Lote. |
AuthenticationMode
O modo de autenticação da conta do Lote.
| Valor | Description |
|---|---|
| SharedKey |
O modo de autenticação usando chaves compartilhadas. |
| AAD |
O modo de autenticação usando a ID do Microsoft Entra. |
| TaskAuthenticationToken |
O modo de autenticação usando tokens de autenticação de tarefa. |
AutoStorageAuthenticationMode
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático.
| Valor | Description |
|---|---|
| StorageKeys |
O serviço lote autenticará solicitações para armazenamento automático usando chaves de conta de armazenamento. |
| BatchAccountManagedIdentity |
O serviço lote autenticará solicitações para armazenamento automático usando a identidade gerenciada atribuída à conta do Lote. |
AutoStorageProperties
Contém informações sobre a conta de armazenamento automático associada a uma conta do Lote.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| authenticationMode | StorageKeys |
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático. |
|
| lastKeySync |
string (date-time) |
A hora UTC em que as chaves de armazenamento foram sincronizadas pela última vez com a conta do Lote. |
|
| nodeIdentityReference |
A referência à identidade atribuída pelo usuário que os nós de computação usarão para acessar o armazenamento automático. |
||
| storageAccountId |
string (arm-id) |
A ID do recurso da conta de armazenamento a ser usada para a conta de armazenamento automático. |
BatchAccount
Contém informações sobre uma conta do Lote do Azure.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
A identidade da conta do Lote. |
||
| location |
string |
A localização geográfica onde o recurso reside |
|
| name |
string |
O nome do recurso |
|
| properties.accountEndpoint |
string |
O ponto de extremidade da conta usado para interagir com o serviço do Lote. |
|
| properties.activeJobAndJobScheduleQuota |
integer (int32) |
A cota de agendamento de trabalho e trabalho ativa para a conta do Lote. |
|
| properties.allowedAuthenticationModes |
Lista de modos de autenticação permitidos para a conta do Lote que pode ser usada para autenticar com o plano de dados. Isso não afeta a autenticação com o plano de controle. |
||
| properties.autoStorage |
As propriedades e o status de qualquer conta de armazenamento automático associada à conta do Lote. |
||
| properties.dedicatedCoreQuota |
integer (int32) |
A cota de núcleo dedicada para a conta do Lote. |
|
| properties.dedicatedCoreQuotaPerVMFamily |
Uma lista da cota de núcleo dedicada por família de Máquinas Virtuais para a conta do Lote. Para contas com PoolAllocationMode definida como UserSubscription, a cota é gerenciada na assinatura para que esse valor não seja retornado. |
||
| properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Um valor que indica se as cotas principais por família de Máquina Virtual são impostas para essa conta |
|
| properties.encryption |
A configuração de criptografia da conta do Lote. |
||
| properties.keyVaultReference |
Uma referência ao cofre de chaves do Azure associado à conta do Lote. |
||
| properties.lowPriorityCoreQuota |
integer (int32) |
A cota de núcleo spot/de baixa prioridade para a conta do Lote. |
|
| properties.networkProfile |
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade. |
||
| properties.nodeManagementEndpoint |
string |
O ponto de extremidade usado pelo nó de computação para se conectar ao serviço de gerenciamento de nós do Lote. |
|
| properties.poolAllocationMode |
O modo de alocação a ser usado para criar pools na conta do Lote. |
||
| properties.poolQuota |
integer (int32) |
A cota do pool para a conta do Lote. |
|
| properties.privateEndpointConnections |
Lista de conexões de ponto de extremidade privado associadas à conta do Lote |
||
| properties.provisioningState |
O estado provisionado do recurso |
||
| properties.publicNetworkAccess | Enabled |
O tipo de interface de rede para acessar o serviço do Lote do Azure e as operações de conta do Lote. |
|
| systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
||
| tags |
object |
Tags de recursos. |
|
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
BatchAccountIdentity
A identidade da conta do Lote, se configurada. Isso é usado quando o usuário especifica 'Microsoft.KeyVault' como a configuração de criptografia da conta do Lote ou quando ManagedIdentity é selecionado como o modo de autenticação de armazenamento automático.
| Nome | Tipo | Description |
|---|---|---|
| principalId |
string |
A ID principal da conta do Lote. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| tenantId |
string |
A ID do locatário associada à conta do Lote. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| type |
O tipo de identidade usado para a conta do Lote. |
|
| userAssignedIdentities |
<string,
User |
A lista de identidades de usuário associadas à conta do Lote. |
CloudError
Uma resposta de erro do serviço do Lote.
| Nome | Tipo | Description |
|---|---|---|
| error |
O corpo da resposta de erro. |
CloudErrorBody
Uma resposta de erro do serviço do Lote.
| Nome | Tipo | Description |
|---|---|---|
| code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
| details |
Uma lista de detalhes adicionais sobre o erro. |
|
| message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
| target |
string |
O destino do erro específico. Por exemplo, o nome da propriedade em erro. |
ComputeNodeIdentityReference
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará.
| Nome | Tipo | Description |
|---|---|---|
| resourceId |
string |
A ID de recurso do ARM da identidade atribuída pelo usuário. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
EncryptionProperties
Configura como os dados do cliente são criptografados dentro da conta do Lote. Por padrão, as contas são criptografadas usando uma chave gerenciada da Microsoft. Para controle adicional, uma chave gerenciada pelo cliente pode ser usada.
| Nome | Tipo | Description |
|---|---|---|
| keySource |
Tipo da origem da chave. |
|
| keyVaultProperties |
Detalhes adicionais ao usar Microsoft.KeyVault |
EndpointAccessDefaultAction
Ação padrão para acesso ao ponto de extremidade. Ela só é aplicável quando publicNetworkAccess está habilitado.
| Valor | Description |
|---|---|
| Allow |
Permitir acesso ao cliente. |
| Deny |
Negar acesso ao cliente. |
EndpointAccessProfile
Perfil de acesso à rede para o ponto de extremidade do Lote.
| Nome | Tipo | Description |
|---|---|---|
| defaultAction |
A ação padrão quando não há nenhum IPRule correspondente. |
|
| ipRules |
IPRule[] |
Matriz de intervalos de IP para filtrar o endereço IP do cliente. |
IPRule
Regra para filtrar o endereço IP do cliente.
| Nome | Tipo | Description |
|---|---|---|
| action |
Ação quando o endereço IP do cliente é correspondido. |
|
| value |
string |
O endereço IP ou o intervalo de endereços IP a ser filtrado |
IPRuleAction
A ação quando o endereço IP do cliente é correspondido.
| Valor | Description |
|---|---|
| Allow |
Permitir acesso para o endereço IP do cliente correspondente. |
KeySource
Tipo da origem da chave.
| Valor | Description |
|---|---|
| Microsoft.Batch |
O Lote cria e gerencia as chaves de criptografia usadas para proteger os dados da conta. |
| Microsoft.KeyVault |
As chaves de criptografia usadas para proteger os dados da conta são armazenadas em um cofre de chaves externo. Se isso for definido, a identidade da Conta do Lote deverá ser definida como |
KeyVaultProperties
Configuração do KeyVault ao usar um KeySource de criptografia do Microsoft.KeyVault.
| Nome | Tipo | Description |
|---|---|---|
| keyIdentifier |
string |
Caminho completo para o segredo com ou sem versão. Exemplo A Conta do Lote tem uma identidade atribuída pelo sistema A identidade da conta recebeu permissões Key/Get, Key/Unwrap e Key/Wrap. O KeyVault tem a proteção de exclusão temporária e limpeza habilitada |
KeyVaultReference
Identifica o cofre de chaves do Azure associado a uma conta do Lote.
| Nome | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
A ID do recurso do cofre de chaves do Azure associado à conta do Lote. |
| url |
string |
A URL do cofre de chaves do Azure associada à conta do Lote. |
NetworkProfile
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade.
| Nome | Tipo | Description |
|---|---|---|
| accountAccess |
Perfil de acesso à rede para o ponto de extremidade batchAccount (API do plano de dados da conta do Lote). |
|
| nodeManagementAccess |
Perfil de acesso à rede para o ponto de extremidade nodeManagement (serviço do Lote que gerencia nós de computação para pools do Lote). |
PoolAllocationMode
O modo de alocação para criar pools na conta do Lote.
| Valor | Description |
|---|---|
| BatchService |
Os pools serão alocados em assinaturas pertencentes ao serviço do Lote. |
| UserSubscription |
Os pools serão alocados em uma assinatura de propriedade do usuário. |
PrivateEndpoint
O ponto de extremidade privado da conexão de ponto de extremidade privado.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
O identificador de recurso arm do ponto de extremidade privado. Isso é do formulário /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Contém informações sobre um recurso de link privado.
| Nome | Tipo | Description |
|---|---|---|
| etag |
string |
A ETag do recurso, usada para instruções de simultaneidade. |
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
O nome do recurso |
| properties.groupIds |
string[] |
A ID do grupo da conexão de ponto de extremidade privado. |
| properties.privateEndpoint |
O identificador de recurso arm do ponto de extremidade privado. |
|
| properties.privateLinkServiceConnectionState |
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado. |
|
| properties.provisioningState |
O estado de provisionamento da conexão de ponto de extremidade privado. |
|
| systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
|
| tags |
object |
As marcas do recurso. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
O estado de provisionamento da conexão de ponto de extremidade privado.
| Valor | Description |
|---|---|
| Creating |
A conexão está sendo criada. |
| Updating |
O usuário solicitou que o status da conexão fosse atualizado, mas a operação de atualização ainda não foi concluída. Talvez você não faça referência à conexão ao conectar a conta do Lote. |
| Deleting |
A conexão está excluindo. |
| Succeeded |
O status da conexão é final e está pronto para uso se o Status for Aprovado. |
| Failed |
O usuário solicitou que a conexão fosse atualizada e ela falhou. Você pode repetir a operação de atualização. |
| Cancelled |
O usuário cancelou a criação da conexão. |
PrivateLinkServiceConnectionState
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado
| Nome | Tipo | Description |
|---|---|---|
| actionsRequired |
string |
Ação necessária no estado de conexão privada |
| description |
string |
Descrição do estado de conexão privada |
| status |
O status da conexão de ponto de extremidade privado do Lote |
PrivateLinkServiceConnectionStatus
O status da conexão de ponto de extremidade privado do Lote
| Valor | Description |
|---|---|
| Approved |
A conexão de ponto de extremidade privado é aprovada e pode ser usada para acessar a conta do Lote |
| Pending |
A conexão de ponto de extremidade privado está pendente e não pode ser usada para acessar a conta do Lote |
| Rejected |
A conexão de ponto de extremidade privado é rejeitada e não pode ser usada para acessar a conta do Lote |
| Disconnected |
A conexão de ponto de extremidade privado está desconectada e não pode ser usada para acessar a conta do Lote |
ProvisioningState
O estado provisionado do recurso
| Valor | Description |
|---|---|
| Invalid |
A conta está em um estado inválido. |
| Creating |
A conta está sendo criada. |
| Deleting |
A conta está sendo excluída. |
| Succeeded |
A conta foi criada e está pronta para uso. |
| Failed |
Falha na última operação da conta. |
| Cancelled |
A última operação da conta foi cancelada. |
PublicNetworkAccessType
O tipo de interface de rede para acessar o serviço do Lote do Azure e as operações de conta do Lote.
| Valor | Description |
|---|---|
| Enabled |
Habilita a conectividade com o Lote do Azure por meio do DNS público. |
| Disabled |
Desabilita a conectividade pública e habilita a conectividade privada com o Serviço de Lote do Azure por meio de um recurso de ponto de extremidade privado. |
| SecuredByPerimeter |
Protege a conectividade com o Lote do Azure por meio da configuração do NSP. |
ResourceIdentityType
O tipo de identidade usado para a conta do Lote.
| Valor | Description |
|---|---|
| SystemAssigned |
A conta do Lote tem uma identidade atribuída pelo sistema com ela. |
| UserAssigned |
A conta do Lote tem identidades atribuídas pelo usuário com ela. |
| None |
A conta do Lote não tem nenhuma identidade associada a ela. A configuração |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UserAssignedIdentities
A lista de identidades de usuário associadas.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
| principalId |
string |
A ID principal da identidade atribuída pelo usuário. |
VirtualMachineFamilyCoreQuota
Uma família de VMs e sua cota de núcleo associada para a conta do Lote.
| Nome | Tipo | Description |
|---|---|---|
| coreQuota |
integer (int32) |
A cota principal da família de VMs para a conta do Lote. |
| name |
string |
O nome da família máquina virtual. |