Compartir a través de


Customers - Get By Billing Account

Obtiene un cliente por su identificador en el nivel de cuenta de facturación. La operación solo se admite para las cuentas de facturación con el tipo de contrato Microsoft Partner Agreement.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}?api-version=2024-04-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
billingAccountName
path True

string

Identificador que identifica de forma única una cuenta de facturación.

Patrón de Regex: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

customerName
path True

string

Identificador que identifica de forma única a un cliente.

Patrón de Regex: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-04-01.

Respuestas

Nombre Tipo Description
200 OK

Customer

Cliente de un asociado.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

CustomersGetByBillingAccount

Solicitud de ejemplo

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/customers/11111111-1111-1111-1111-111111111111?api-version=2024-04-01

Respuesta de muestra

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/customers/11111111-1111-1111-1111-111111111111",
  "name": "11111111-1111-1111-1111-111111111111",
  "properties": {
    "billingProfileDisplayName": "Contoso Operations Billing",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
    "displayName": "customer1",
    "systemId": "yyyy-yyyy-yyy-yyy",
    "status": "Active",
    "enabledAzurePlans": [
      {
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Plan for DevTest"
      }
    ],
    "resellers": [
      {
        "resellerId": "89e87bdf-a2a2-4687-925f-4c18b27bccfd",
        "description": "Reseller1"
      },
      {
        "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
        "description": "Reseller2"
      }
    ],
    "tags": {
      "pcCode": "A123456",
      "costCategory": "Support"
    }
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/customers"
}

Definiciones

Nombre Description
AzurePlan

Detalles del plan de Azure.

createdByType

Tipo de identidad que creó el recurso.

Customer

Cliente de un asociado.

CustomerProperties

Cliente de un asociado.

CustomerStatus

Identifica el estado de un cliente. Esta es una propiedad próxima que se rellenará en el futuro.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

Reseller

Detalles del revendedor.

systemData

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

AzurePlan

Detalles del plan de Azure.

Nombre Tipo Description
productId

string

Identificador que identifica de forma única un producto.

skuDescription

string

Descripción de la SKU.

skuId

string

Identificador que identifica de forma única una SKU.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Cliente de un asociado.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso

properties

CustomerProperties

Cliente de un asociado.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.

tags

object

Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? /

type

string

Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

CustomerProperties

Cliente de un asociado.

Nombre Tipo Description
billingProfileDisplayName

string

Nombre del perfil de facturación.

billingProfileId

string

Identificador completo que identifica de forma única un perfil de facturación.

displayName

string

Nombre del cliente.

enabledAzurePlans

AzurePlan[]

Planes de Azure habilitados para el cliente.

resellers

Reseller[]

Lista de revendedores para los que está habilitado un plan de Azure para el cliente.

status

CustomerStatus

Identifica el estado de un cliente. Esta es una propiedad próxima que se rellenará en el futuro.

systemId

string

El sistema generó un identificador único para un cliente.

tags

object

Diccionario de metadatos asociados al recurso. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? /

CustomerStatus

Identifica el estado de un cliente. Esta es una propiedad próxima que se rellenará en el futuro.

Nombre Tipo Description
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

Reseller

Detalles del revendedor.

Nombre Tipo Description
description

string

Nombre del revendedor.

resellerId

string

Identificador de MPN del revendedor.

systemData

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

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.