Managed Instances - List By Resource Group
Obtém uma lista de instâncias gerenciadas em um grupo de recursos.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2021-11-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal. |
subscription
|
path | True |
string |
A ID de assinatura que identifica uma assinatura do Azure. |
api-version
|
query | True |
string |
A versão da API a ser usada para a solicitação. |
$expand
|
query |
string |
Os recursos filho a serem incluídos na resposta. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Recuperou com êxito a lista de instâncias gerenciadas. |
|
Other Status Codes |
Respostas de erro: ***
|
Exemplos
List managed instances by resource group |
List managed instances by resource group with $expand=administrators/activedirectory |
List managed instances by resource group
Solicitação de exemplo
Resposta de exemplo
{
"value": [
{
"location": "japaneast",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
"name": "testinstance1",
"type": "Microsoft.Sql/managedInstances",
"sku": {
"name": "GP_Gen4",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo"
}
},
{
"location": "japaneast",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
"name": "testinstance2",
"type": "Microsoft.Sql/managedInstances",
"sku": {
"name": "BC_Gen5",
"tier": "BusinessCritical",
"capacity": 16,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 16,
"storageSizeInGB": 1024,
"licenseType": "Full",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "2c3d1bdae3412",
"maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo"
}
}
]
}
List managed instances by resource group with $expand=administrators/activedirectory
Solicitação de exemplo
Resposta de exemplo
{
"value": [
{
"location": "japaneast",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
"name": "testinstance1",
"type": "Microsoft.Sql/managedInstances",
"sku": {
"name": "GP_Gen4",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
}
}
},
{
"location": "japaneast",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
"name": "testinstance2",
"type": "Microsoft.Sql/managedInstances",
"sku": {
"name": "BC_Gen5",
"tier": "BusinessCritical",
"capacity": 16,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 16,
"storageSizeInGB": 1024,
"licenseType": "Full",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "2c3d1bdae3412",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
}
}
}
]
}
Definições
Nome | Description |
---|---|
Administrator |
Tipo do administrador de sever. |
Backup |
O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
Identity |
O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso. |
Managed |
Uma instância gerenciada SQL do Azure. |
Managed |
Propriedades de um administrador do Active Directory. |
Managed |
O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusivo de uma nova licença SQL) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL). |
Managed |
Uma lista de instâncias gerenciadas. |
Managed |
Uma conexão de ponto de extremidade privado em uma instância gerenciada |
Managed |
Propriedades de uma conexão de ponto de extremidade privado. |
Managed |
|
Managed |
|
Managed |
Tipo de conexão usado para se conectar à instância. |
Managed |
Especifica o modo de criação do banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados. |
Principal |
Tipo principal do administrador de sever. |
Resource |
Configuração de identidade do Azure Active Directory para um recurso. |
Service |
A configuração da entidade de serviço da instância gerenciada para um recurso. |
Service |
Tipo de entidade de serviço. |
Sku |
Um SKU de recurso do ARM. |
User |
Configuração de identidade do Azure Active Directory para um recurso. |
AdministratorType
Tipo do administrador de sever.
Nome | Tipo | Description |
---|---|---|
ActiveDirectory |
string |
BackupStorageRedundancy
O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
Nome | Tipo | Description |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
IdentityType
O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManagedInstance
Uma instância gerenciada SQL do Azure.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso. |
identity |
A identidade do Azure Active Directory da instância gerenciada. |
|
location |
string |
Local do recurso. |
name |
string |
Nome do recurso. |
properties.administratorLogin |
string |
Nome de usuário do administrador para a instância gerenciada. Só pode ser especificado quando a instância gerenciada está sendo criada (e é necessária para a criação). |
properties.administratorLoginPassword |
string |
A senha de logon do administrador (necessária para a criação da instância gerenciada). |
properties.administrators |
O administrador do Azure Active Directory do servidor. |
|
properties.collation |
string |
Ordenação da instância gerenciada. |
properties.currentBackupStorageRedundancy |
O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
properties.dnsZone |
string |
A Zona Dns em que a instância gerenciada está. |
properties.dnsZonePartner |
string |
A ID do recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. |
properties.fullyQualifiedDomainName |
string |
O nome de domínio totalmente qualificado da instância gerenciada. |
properties.instancePoolId |
string |
A ID do pool de instâncias à qual este servidor gerenciado pertence. |
properties.keyId |
string |
Um URI cmk da chave a ser usada para criptografia. |
properties.licenseType |
O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusivo de uma nova licença SQL) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL). |
|
properties.maintenanceConfigurationId |
string |
Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada. |
properties.managedInstanceCreateMode |
Especifica o modo de criação do banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados. |
|
properties.minimalTlsVersion |
string |
Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' |
properties.primaryUserAssignedIdentityId |
string |
A ID do recurso de uma identidade atribuída pelo usuário a ser usada por padrão. |
properties.privateEndpointConnections |
Lista de conexões de ponto de extremidade privado em uma instância gerenciada. |
|
properties.provisioningState |
enum:
|
|
properties.proxyOverride |
Tipo de conexão usado para se conectar à instância. |
|
properties.publicDataEndpointEnabled |
boolean |
Se o ponto de extremidade de dados público está habilitado ou não. |
properties.requestedBackupStorageRedundancy |
O tipo de conta de armazenamento a ser usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
properties.restorePointInTime |
string |
Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. |
properties.servicePrincipal |
A entidade de serviço da instância gerenciada. |
|
properties.sourceManagedInstanceId |
string |
O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância. |
properties.state |
string |
O estado da instância gerenciada. |
properties.storageSizeInGB |
integer |
Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. |
properties.subnetId |
string |
ID do recurso de sub-rede para a instância gerenciada. |
properties.timezoneId |
string |
Id do fuso horário. Os valores permitidos são fusos horários compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos Horários. Você pode obter esses valores do Registro por meio de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Hora Padrão do Pacífico" ou "W. Hora Padrão da Europa". |
properties.vCores |
integer |
O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. |
properties.zoneRedundant |
boolean |
Se o multi-az está habilitado ou não. |
sku |
SKU de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH |
|
tags |
object |
Marcas de recurso. |
type |
string |
Tipo de recurso. |
ManagedInstanceExternalAdministrator
Propriedades de um administrador do Active Directory.
Nome | Tipo | Description |
---|---|---|
administratorType |
Tipo do administrador de sever. |
|
azureADOnlyAuthentication |
boolean |
Somente autenticação do Azure Active Directory habilitada. |
login |
string |
Nome de logon do administrador do servidor. |
principalType |
Tipo principal do administrador de sever. |
|
sid |
string |
SID (ID do objeto) do administrador do servidor. |
tenantId |
string |
ID do locatário do administrador. |
ManagedInstanceLicenseType
O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusivo de uma nova licença SQL) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL).
Nome | Tipo | Description |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ManagedInstanceListResult
Uma lista de instâncias gerenciadas.
Nome | Tipo | Description |
---|---|---|
nextLink |
string |
Link para recuperar a próxima página de resultados. |
value |
Matriz de resultados. |
ManagedInstancePecProperty
Uma conexão de ponto de extremidade privado em uma instância gerenciada
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso. |
properties |
Propriedades de conexão de ponto de extremidade privado |
ManagedInstancePrivateEndpointConnectionProperties
Propriedades de uma conexão de ponto de extremidade privado.
Nome | Tipo | Description |
---|---|---|
privateEndpoint |
Ponto de extremidade privado ao qual a conexão pertence. |
|
privateLinkServiceConnectionState |
Estado de conexão da conexão de ponto de extremidade privado. |
|
provisioningState |
string |
Estado da Conexão de Ponto de Extremidade Privado. |
ManagedInstancePrivateEndpointProperty
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso do ponto de extremidade privado. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Nome | Tipo | Description |
---|---|---|
actionsRequired |
string |
A descrição da conexão do serviço de link privado. |
description |
string |
A descrição da conexão do serviço de link privado. |
status |
string |
A conexão do serviço de link privado status. |
ManagedInstanceProxyOverride
Tipo de conexão usado para se conectar à instância.
Nome | Tipo | Description |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
ManagedServerCreateMode
Especifica o modo de criação do banco de dados.
Padrão: criação de instância regular.
Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.
Nome | Tipo | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
PrincipalType
Tipo principal do administrador de sever.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
ResourceIdentity
Configuração de identidade do Azure Active Directory para um recurso.
Nome | Tipo | Description |
---|---|---|
principalId |
string |
A ID da entidade de segurança do Azure Active Directory. |
tenantId |
string |
A ID do locatário do Azure Active Directory. |
type |
O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso. |
|
userAssignedIdentities |
<string,
User |
As IDs de recurso das identidades atribuídas pelo usuário a serem usadas |
ServicePrincipal
A configuração da entidade de serviço da instância gerenciada para um recurso.
Nome | Tipo | Description |
---|---|---|
clientId |
string |
A ID do cliente do aplicativo Azure Active Directory. |
principalId |
string |
A ID do objeto de aplicativo do Azure Active Directory. |
tenantId |
string |
A ID do locatário do Azure Active Directory. |
type |
Tipo de entidade de serviço. |
ServicePrincipalType
Tipo de entidade de serviço.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
Sku
Um SKU de recurso do ARM.
Nome | Tipo | Description |
---|---|---|
capacity |
integer |
Capacidade do SKU específico. |
family |
string |
Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. |
name |
string |
O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. |
size |
string |
Tamanho do SKU específico |
tier |
string |
A camada ou edição do SKU específico, por exemplo, Básico, Premium. |
UserIdentity
Configuração de identidade do Azure Active Directory para um recurso.
Nome | Tipo | Description |
---|---|---|
clientId |
string |
A ID do cliente do Azure Active Directory. |
principalId |
string |
A ID da entidade de segurança do Azure Active Directory. |