Compartir a través de


Enrollment Accounts - List By Department

Enumera las cuentas de inscripción de un departamento. La operación solo se admite para las cuentas de facturación con el tipo de contrato Enterprise Agreement.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/enrollmentAccounts?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/enrollmentAccounts?api-version=2024-04-01&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
billingAccountName
path True

string

pattern: ^([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})?)$

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

departmentName
path True

string

pattern: ^[a-zA-Z\d-_]{1,128}$

Nombre del departamento.

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.

count
query

boolean

La opción de consulta count permite a los clientes solicitar un recuento de los recursos coincidentes incluidos con los recursos de la respuesta.

filter
query

string

La opción de consulta de filtro permite a los clientes filtrar una colección de recursos que se abordan mediante una dirección URL de solicitud.

orderBy
query

string

La opción de consulta orderby permite a los clientes solicitar recursos en un orden determinado.

search
query

string

La opción de consulta de búsqueda permite a los clientes solicitar elementos dentro de una colección que coincida con una expresión de búsqueda de texto libre. la búsqueda solo se admite para campos de cadena.

skip
query

integer (int64)

La opción omitir consulta solicita el número de elementos de la colección consultada que se omitirán y no se incluirán en el resultado.

top
query

integer (int64)

La opción de consulta superior solicita el número de elementos de la colección consultada que se incluirán en el resultado. El valor máximo admitido para top es 50.

Respuestas

Nombre Tipo Description
200 OK

EnrollmentAccountListResult

De acuerdo. La solicitud se ha realizado correctamente.

Other Status Codes

ErrorResponse

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

Ejemplos

EnrollmentAccountsListByDepartment

Solicitud de ejemplo

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/6564892/departments/164821/enrollmentAccounts?api-version=2024-04-01

Respuesta de muestra

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6564892/departments/164821/enrollmentAccounts/257698",
      "name": "257698",
      "properties": {
        "costCenter": "C0",
        "displayName": "AccountName0",
        "departmentDisplayName": "TestDept",
        "departmentId": "164821",
        "isDevTestEnabled": true,
        "accountOwner": "account0@contoso.com",
        "authType": "MicrosoftAccount",
        "status": "Active",
        "startDate": "2018-05-01T17:32:28Z",
        "endDate": "2019-05-31T17:32:28Z"
      },
      "type": "Microsoft.Billing/billingAccounts/departments/enrollmentAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6564892/departments/164821/enrollmentAccounts/264698",
      "name": "264698",
      "properties": {
        "costCenter": "C1",
        "displayName": "AccountName1",
        "departmentDisplayName": "TestDept",
        "departmentId": "164821",
        "isDevTestEnabled": false,
        "accountOwner": "account1@contoso.com",
        "authType": "Organization",
        "status": "Active",
        "startDate": "2018-05-01T17:32:28Z",
        "endDate": "2019-05-31T17:32:28Z"
      },
      "type": "Microsoft.Billing/billingAccounts/departments/enrollmentAccounts"
    }
  ]
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

EnrollmentAccount

Es una jerarquía organizativa dentro de una cuenta de facturación para administrar y administrar los costos de Azure.

EnrollmentAccountListResult

Un contenedor para obtener una lista de recursos

EnrollmentAccountProperties

Es una jerarquía organizativa dentro de una cuenta de facturación para administrar y administrar los costos de Azure.

ErrorAdditionalInfo

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

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

systemData

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

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

EnrollmentAccount

Es una jerarquía organizativa dentro de una cuenta de facturación para administrar y administrar los costos de Azure.

Nombre Tipo Description
id

string (arm-id)

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

name

string

Nombre del recurso

properties

EnrollmentAccountProperties

Es una jerarquía organizativa dentro de una cuenta de facturación para administrar y administrar los costos de Azure.

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"

EnrollmentAccountListResult

Un contenedor para obtener una lista de recursos

Nombre Tipo Description
nextLink

string

Vínculo (url) a la página siguiente de resultados.

value

EnrollmentAccount[]

Lista de recursos.

EnrollmentAccountProperties

Es una jerarquía organizativa dentro de una cuenta de facturación para administrar y administrar los costos de Azure.

Nombre Tipo Description
accountOwner

string

Propietario de la cuenta de inscripción.

authType

string

Tipo de autorización de la cuenta de inscripción.

costCenter

string

Centro de costos asociado a la cuenta de inscripción.

departmentDisplayName

string

Nombre del departamento en el que existe la cuenta de inscripción.

departmentId

string

Identificador que identifica de forma única el departamento.

displayName

string

Nombre de la cuenta de inscripción.

endDate

string (date-time)

Fecha de expiración de la cuenta de inscripción.

isDevTestEnabled

boolean

Marca booleana que permite a los suscriptores ejecutar cargas de trabajo de desarrollo y pruebas en Azure con tarifas especiales de desarrollo y pruebas.

startDate

string (date-time)

Fecha a partir de la cual la cuenta de inscripción se convirtió en válida y funcional.

status

string

Estado de la cuenta de inscripción.

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.

systemData

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

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

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

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