Sandbox Groups - List By Resource Group

Servicio:: Container Instances

Versión de la API:: 2026-07-01

Lista los recursos de Sandbox Group por grupo de recursos

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/sandboxGroups?api-version=2026-07-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	SandboxGroupListResult	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar su cuenta de usuario

Ejemplos

List SandboxGroups by resource group

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/sandboxGroups?api-version=2026-07-01

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/sandboxGroups/mySandboxGroup",
      "name": "mySandboxGroup",
      "type": "Microsoft.ContainerInstance/sandboxGroups",
      "location": "eastus",
      "tags": {
        "environment": "test"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "networkProfile": {
          "subnets": [
            {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"
            }
          ]
        },
        "managementResourceGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mySandboxGroup-mrg"
      }
    }
  ]
}

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio Container Instance.
CloudErrorBody	Respuesta de error del servicio Container Instance.
createdByType	Tipo de identidad que creó el recurso.
ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
SandboxGroup	Un recurso rastreado por SandboxGroup.
SandboxGroupListResult	La respuesta de una operación de lista SandboxGroup.
SandboxGroupNetworkProfile	El perfil de red para un Sandbox Group.
SandboxGroupProperties	Propiedades de un Sandbox Group.
SandboxGroupProvisioningState	El estado de aprovisionamiento de un recurso SandboxGroup.
SubnetReference	Una referencia a un recurso de subred.
systemData	Metadatos relativos a la creación y última modificación del recurso.
UserAssignedIdentities	Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

CloudError

Objeto

Respuesta de error del servicio Container Instance.

Nombre	Tipo	Description
error	CloudErrorBody	Respuesta de error del servicio Container Instance.

CloudErrorBody

Objeto

Respuesta de error del servicio Container Instance.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Una lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ManagedServiceIdentity

Objeto

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre	Tipo	Description
principalId	string (uuid)	Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string (uuid)	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	UserAssignedIdentities	Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

SandboxGroup

Objeto

Un recurso rastreado por SandboxGroup.

Nombre	Tipo	Description
id	string (arm-id)	Identificador completamente cualificado del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identidades de servicio administradas asignadas a este recurso.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties	SandboxGroupProperties	Propiedades específicas del recurso para este recurso.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SandboxGroupListResult

Objeto

La respuesta de una operación de lista SandboxGroup.

Nombre	Tipo	Description
nextLink	string (uri)	Vínculo a la página siguiente de elementos
value	SandboxGroup[]	Los elementos del SandboxGroup en esta página

SandboxGroupNetworkProfile

Objeto

El perfil de red para un Sandbox Group.

Nombre	Tipo	Description
subnets	SubnetReference[]	La lista de subredes asociadas con el SandboxGroup.

SandboxGroupProperties

Objeto

Propiedades de un Sandbox Group.

Nombre	Tipo	Description
managementResourceGroupId	string (arm-id)	El ID de recurso ARM del grupo de recursos de gestión asociado a este SandboxGroup.
networkProfile	SandboxGroupNetworkProfile	El perfil de la red del SandboxGroup.
provisioningState	SandboxGroupProvisioningState	Estado de la última operación.

SandboxGroupProvisioningState

Enumeración

El estado de aprovisionamiento de un recurso SandboxGroup.

Valor	Description
Succeeded	Se ha creado el recurso.
Failed	Error en la creación de recursos.
Canceled	Se canceló la creación de recursos.
Updating	Se está actualizando el recurso.
Deleting	El recurso se está eliminando.
Accepted	La solicitud de provisionamiento de recursos fue aceptada pero aún no había comenzado.

SubnetReference

Objeto

Una referencia a un recurso de subred.

Nombre	Tipo	Description
id	string (arm-id)	El ID de recurso ARM de la subred. El llamante debe tener `Microsoft.Network/virtualNetworks/subnets/join/action` permiso en esta subred (aplicado mediante una comprobación de acceso vinculada en el momento de crear/actualizar).

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	La identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	La identidad que modificó el recurso por última vez.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserAssignedIdentities

Objeto

Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada por el usuario.
principalId	string	Identificador principal de la identidad asignada por el usuario.