Compartir a través de

Registro de inquilinos para el seguimiento de uso en Azure Stack Hub

Este artículo contiene detalles sobre las operaciones de registro. Puede usar estas operaciones para:

  • Administrar registros de inquilinos.
  • Administrar el seguimiento del uso de los inquilinos.

Adición de un inquilino al registro

Puede usar esta operación cuando quiera agregar un nuevo inquilino al registro. El uso del inquilino se informa bajo una suscripción de Azure vinculada al inquilino de Microsoft Entra.

También puede usar esta operación para cambiar la suscripción asociada a un inquilino. Llame a PUT o al cmdlet New-AzResource de PowerShell para sobrescribir la asignación anterior. Si usa el módulo de AzureRM de PowerShell, use el cmdlet New-AzureRMResource de PowerShell.

Puede asociar una sola suscripción de Azure a un inquilino. Si intenta agregar una segunda suscripción a un inquilino existente, se sobrescribe la primera suscripción.

Uso de perfiles de API

Los siguientes cmdlets de registro requieren que especifique un perfil de API al ejecutar PowerShell. Los perfiles de API representan un conjunto de proveedores de recursos de Azure y sus versiones de API. Ayudan a usar la versión correcta de la API al interactuar con varias nubes de Azure. Por ejemplo, si gestiona varias nubes al usar Azure Global y Azure Stack Hub, los perfiles de API especifican un nombre que coincida con su fecha de lanzamiento. Use el perfil 2017-09-03.

Para más información sobre los perfiles de API y Azure Stack Hub, consulte Administración de perfiles de versión de API en Azure Stack Hub.

Parámetros

Parámetro Descripción
registrationSubscriptionID La suscripción de Azure que se usó para el registro inicial.
ID de Suscripción del Cliente La suscripción de Azure (no Azure Stack Hub) a la que pertenece el cliente que se va a registrar. Debe crearse en la oferta del proveedor de soluciones en la nube (CSP) mediante el Centro de partners. Si un cliente tiene más de un inquilino, cree una suscripción para que el inquilino inicie sesión en Azure Stack Hub. El identificador de suscripción del cliente distingue mayúsculas y minúsculas.
resourceGroup Grupo de recursos en Azure en el que se almacena el registro.
nombre de registro El nombre del registro de tu Azure Stack Hub. Es un objeto almacenado en Azure. El nombre suele tener el formato azurestack-CloudID, donde CloudID es el identificador de nube de la implementación de Azure Stack Hub.

Nota

Los inquilinos deben registrarse con cada implementación de Azure Stack Hub que usen. Si un inquilino usa más de una instancia de Azure Stack Hub, actualice los registros iniciales de cada implementación con la suscripción de inquilino.

PowerShell

Use el cmdlet New-AzResource para agregar un inquilino. Conéctese a Azure y, luego, ejecute el siguiente comando desde el símbolo del sistema con privilegios elevados:

New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Llamada API

Operación: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Respuesta: 201 Creado
Respuesta Cuerpo: Vacío

Enumerar todos los inquilinos registrados

Obtenga una lista de todos los inquilinos que se han agregado a un registro.

Nota

Si no se ha registrado ningún inquilino, no recibirá una respuesta.

Parámetros

Parámetro Descripción
registrationSubscriptionId La suscripción de Azure que se usó para el registro inicial.
resourceGroup Grupo de recursos en Azure en el que se almacena el registro.
nombre de registro El nombre del registro de su implementación de Azure Stack Hub. Es un objeto almacenado en Azure. El nombre suele estar en forma de azurestack-CloudID, donde CloudID es el identificador de nube de la implementación de Azure Stack Hub.

PowerShell

Use el cmdlet Get-AzResource para enumerar todos los inquilinos registrados. Conéctese a Azure Stack Hub y, después, desde un símbolo del sistema con privilegios elevados, ejecute el siguiente cmdlet:

Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

Llamada API

Puede obtener una lista de todas las asignaciones de inquilinos mediante la operación GET.

Operación: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Respuesta: 200
Cuerpo de respuesta:

{
    "value": [{
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 1}",
            "name": " cspSubscriptionId 1",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId1" }
        },
        {
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 2}",
            "name": " cspSubscriptionId2 ",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId2" }
        }
    ],
    "nextLink": "{originalRequestUrl}?$skipToken={opaqueString}"
}

Eliminación de una asignación de inquilinos

Puede quitar un inquilino que se haya agregado a un registro. Si ese inquilino sigue usando recursos en Azure Stack Hub, su uso se cobra a la suscripción usada en el registro inicial de Azure Stack Hub.

Parámetros

Parámetro Descripción
registrationSubscriptionId Identificador de suscripción para el registro.
resourceGroup El grupo de recursos para el registro.
nombre de registro Nombre del registro.
customerSubscriptionId Identificador de suscripción del cliente. El identificador de suscripción del cliente distingue mayúsculas y minúsculas.

PowerShell

Use el cmdlet Remove-AzResource para quitar un inquilino. Conéctese a Azure Stack Hub y, después, desde un símbolo del sistema con privilegios elevados, ejecute el siguiente cmdlet:

Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Llamada API

Se pueden quitar las asignaciones de inquilinos mediante la operación DELETE.

Operación: ELIMINAR
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
respuesta: 204 Sin contenido
Respuesta Cuerpo: Vacío

Pasos siguientes

  • Last updated on