Freigeben über


Billing Role Definition - List By Billing Account

Listet die Rollendefinitionen für ein Abrechnungskonto auf. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement, Microsoft Customer Agreement oder Enterprise Agreement unterstützt.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
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})?)$

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

api-version
query True

string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2024-04-01.

Antworten

Name Typ Beschreibung
200 OK

BillingRoleDefinitionListResult

Die Liste der Rollendefinitionen.

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

BillingRoleDefinitionListByBillingAccount

Beispielanforderung

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

Beispiel für eine Antwort

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingRoleDefinitions/50000000-aaaa-bbbb-cccc-100000000000",
      "name": "50000000-aaaa-bbbb-cccc-100000000000",
      "properties": {
        "permissions": [
          {
            "actions": [
              "50000000-aaaa-bbbb-cccc-200000000000",
              "50000000-aaaa-bbbb-cccc-200000000001",
              "50000000-aaaa-bbbb-cccc-200000000002",
              "50000000-aaaa-bbbb-cccc-200000000003",
              "50000000-aaaa-bbbb-cccc-200000000004",
              "50000000-aaaa-bbbb-cccc-200000000006",
              "50000000-aaaa-bbbb-cccc-200000000007",
              "50000000-aaaa-bbbb-cccc-200000000008",
              "10000000-aaaa-bbbb-cccc-200000000001",
              "10000000-aaaa-bbbb-cccc-200000000002",
              "10000000-aaaa-bbbb-cccc-200000000003",
              "10000000-aaaa-bbbb-cccc-200000000006",
              "10000000-aaaa-bbbb-cccc-200000000007",
              "50000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000000",
              "30000000-aaaa-bbbb-cccc-200000000001",
              "30000000-aaaa-bbbb-cccc-200000000004",
              "30000000-aaaa-bbbb-cccc-200000000007",
              "30000000-aaaa-bbbb-cccc-200000000009",
              "30000000-aaaa-bbbb-cccc-200000000010",
              "30000000-aaaa-bbbb-cccc-200000000015",
              "30000000-aaaa-bbbb-cccc-200000000017",
              "30000000-aaaa-bbbb-cccc-200000000018",
              "40000000-aaaa-bbbb-cccc-200000000000",
              "40000000-aaaa-bbbb-cccc-200000000006",
              "40000000-aaaa-bbbb-cccc-200000000007",
              "40000000-aaaa-bbbb-cccc-200000000008",
              "40000000-aaaa-bbbb-cccc-200000000012",
              "40000000-aaaa-bbbb-cccc-200000000013",
              "40000000-aaaa-bbbb-cccc-200000000004",
              "40000000-aaaa-bbbb-cccc-200000000001",
              "40000000-aaaa-bbbb-cccc-200000000005",
              "40000000-aaaa-bbbb-cccc-200000000002",
              "40000000-aaaa-bbbb-cccc-200000000003",
              "40000000-aaaa-bbbb-cccc-200000000011",
              "30000000-aaaa-bbbb-cccc-200000000013",
              "30000000-aaaa-bbbb-cccc-200000000011",
              "30000000-aaaa-bbbb-cccc-200000000006",
              "30000000-aaaa-bbbb-cccc-200000000003",
              "30000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000012",
              "30000000-aaaa-bbbb-cccc-200000000008",
              "30000000-aaaa-bbbb-cccc-200000000016"
            ]
          }
        ],
        "roleName": "Billing account owner"
      },
      "type": "Microsoft.Billing/billingAccounts/billingRoleDefinitions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingRoleDefinitions/50000000-aaaa-bbbb-cccc-100000000001",
      "name": "50000000-aaaa-bbbb-cccc-100000000001",
      "properties": {
        "description": "The Contributor role gives the user all permissions except access management on the organization.",
        "permissions": [
          {
            "actions": [
              "50000000-aaaa-bbbb-cccc-200000000001",
              "50000000-aaaa-bbbb-cccc-200000000002",
              "50000000-aaaa-bbbb-cccc-200000000003",
              "50000000-aaaa-bbbb-cccc-200000000004",
              "50000000-aaaa-bbbb-cccc-200000000006",
              "50000000-aaaa-bbbb-cccc-200000000007",
              "50000000-aaaa-bbbb-cccc-200000000008",
              "10000000-aaaa-bbbb-cccc-200000000001",
              "10000000-aaaa-bbbb-cccc-200000000002",
              "10000000-aaaa-bbbb-cccc-200000000003",
              "10000000-aaaa-bbbb-cccc-200000000006",
              "10000000-aaaa-bbbb-cccc-200000000007",
              "50000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000001",
              "30000000-aaaa-bbbb-cccc-200000000004",
              "30000000-aaaa-bbbb-cccc-200000000007",
              "30000000-aaaa-bbbb-cccc-200000000009",
              "30000000-aaaa-bbbb-cccc-200000000010",
              "30000000-aaaa-bbbb-cccc-200000000015",
              "30000000-aaaa-bbbb-cccc-200000000017",
              "30000000-aaaa-bbbb-cccc-200000000018",
              "40000000-aaaa-bbbb-cccc-200000000006",
              "40000000-aaaa-bbbb-cccc-200000000007",
              "40000000-aaaa-bbbb-cccc-200000000008",
              "40000000-aaaa-bbbb-cccc-200000000012",
              "40000000-aaaa-bbbb-cccc-200000000013",
              "40000000-aaaa-bbbb-cccc-200000000004",
              "40000000-aaaa-bbbb-cccc-200000000001",
              "40000000-aaaa-bbbb-cccc-200000000005",
              "40000000-aaaa-bbbb-cccc-200000000002",
              "40000000-aaaa-bbbb-cccc-200000000003",
              "40000000-aaaa-bbbb-cccc-200000000011",
              "30000000-aaaa-bbbb-cccc-200000000013",
              "30000000-aaaa-bbbb-cccc-200000000011",
              "30000000-aaaa-bbbb-cccc-200000000006",
              "30000000-aaaa-bbbb-cccc-200000000003",
              "30000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000012",
              "30000000-aaaa-bbbb-cccc-200000000008",
              "30000000-aaaa-bbbb-cccc-200000000016"
            ]
          }
        ],
        "roleName": "Billing account contributor"
      },
      "type": "Microsoft.Billing/billingAccounts/billingRoleDefinitions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingRoleDefinitions/50000000-aaaa-bbbb-cccc-100000000002",
      "name": "50000000-aaaa-bbbb-cccc-100000000002",
      "properties": {
        "description": "The Reader role gives the user read permissions to an organization.",
        "permissions": [
          {
            "actions": [
              "50000000-aaaa-bbbb-cccc-200000000001",
              "50000000-aaaa-bbbb-cccc-200000000006",
              "50000000-aaaa-bbbb-cccc-200000000007",
              "10000000-aaaa-bbbb-cccc-200000000003",
              "50000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000001",
              "30000000-aaaa-bbbb-cccc-200000000004",
              "30000000-aaaa-bbbb-cccc-200000000007",
              "30000000-aaaa-bbbb-cccc-200000000010",
              "30000000-aaaa-bbbb-cccc-200000000015",
              "30000000-aaaa-bbbb-cccc-200000000017",
              "40000000-aaaa-bbbb-cccc-200000000006",
              "40000000-aaaa-bbbb-cccc-200000000007",
              "40000000-aaaa-bbbb-cccc-200000000008",
              "40000000-aaaa-bbbb-cccc-200000000012"
            ]
          }
        ],
        "roleName": "Billing account reader"
      },
      "type": "Microsoft.Billing/billingAccounts/billingRoleDefinitions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingRoleDefinitions/50000000-aaaa-bbbb-cccc-100000000002",
      "name": "50000000-aaaa-bbbb-cccc-100000000002",
      "properties": {
        "description": "The Reader role gives the user read permissions to an organization.",
        "permissions": [
          {
            "actions": [
              "50000000-aaaa-bbbb-cccc-200000000001",
              "50000000-aaaa-bbbb-cccc-200000000006",
              "50000000-aaaa-bbbb-cccc-200000000007",
              "10000000-aaaa-bbbb-cccc-200000000003",
              "50000000-aaaa-bbbb-cccc-200000000005",
              "30000000-aaaa-bbbb-cccc-200000000001",
              "30000000-aaaa-bbbb-cccc-200000000004",
              "30000000-aaaa-bbbb-cccc-200000000007",
              "30000000-aaaa-bbbb-cccc-200000000010",
              "30000000-aaaa-bbbb-cccc-200000000015",
              "30000000-aaaa-bbbb-cccc-200000000017",
              "40000000-aaaa-bbbb-cccc-200000000006",
              "40000000-aaaa-bbbb-cccc-200000000007",
              "40000000-aaaa-bbbb-cccc-200000000008",
              "40000000-aaaa-bbbb-cccc-200000000012"
            ]
          }
        ],
        "roleName": "Billing account reader"
      },
      "type": "Microsoft.Billing/billingAccounts/billingRoleDefinitions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingRoleDefinitions/50000000-aaaa-bbbb-cccc-100000000003",
      "name": "50000000-aaaa-bbbb-cccc-100000000003",
      "properties": {
        "description": "The Purchaser role gives the user permissions to make purchases by creating new Projects and Billing Groups in an organization.",
        "permissions": [
          {
            "actions": [
              "10000000-aaaa-bbbb-cccc-200000000006",
              "10000000-aaaa-bbbb-cccc-200000000007",
              "50000000-aaaa-bbbb-cccc-200000000001",
              "50000000-aaaa-bbbb-cccc-200000000006"
            ]
          }
        ],
        "roleName": "Basic Purchaser"
      },
      "type": "Microsoft.Billing/billingAccounts/billingRoleDefinitions"
    }
  ]
}

Definitionen

Name Beschreibung
BillingPermission

Der Satz zulässiger Aktionen und nicht zulässiger Aktionen, die ein Aufrufer für eine Ressource hat.

BillingRoleDefinition

Die Eigenschaften einer Rollendefinition.

BillingRoleDefinitionListResult

Ein Container für eine Liste von Ressourcen

BillingRoleDefinitionProperties

Die Eigenschaften einer Rollendefinition.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

BillingPermission

Der Satz zulässiger Aktionen und nicht zulässiger Aktionen, die ein Aufrufer für eine Ressource hat.

Name Typ Beschreibung
actions

string[]

Die Gruppe von Aktionen, die der Aufrufer ausführen darf.

notActions

string[]

Der Satz von Aktionen, die der Aufrufer nicht ausführen darf.

BillingRoleDefinition

Die Eigenschaften einer Rollendefinition.

Name Typ Beschreibung
id

string (arm-id)

Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Der Name der Ressource

properties

BillingRoleDefinitionProperties

Die Eigenschaften einer Rollendefinition.

systemData

systemData

Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.

tags

object

Wörterbuch der Metadaten, die der Ressource zugeordnet sind. Möglicherweise wird sie nicht für alle Ressourcentypen aufgefüllt. Maximale Schlüssel-/Wertlänge unterstützt von 256 Zeichen. Schlüssel/Wert dürfen keinen leeren Wert oder null sein. Schlüssel können nicht <> % & \ enthalten? /

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

BillingRoleDefinitionListResult

Ein Container für eine Liste von Ressourcen

Name Typ Beschreibung
nextLink

string

Der Link (URL) zur nächsten Seite der Ergebnisse.

value

BillingRoleDefinition[]

Die Liste der Ressourcen.

BillingRoleDefinitionProperties

Die Eigenschaften einer Rollendefinition.

Name Typ Beschreibung
description

string

Die Rollenbeschreibung.

permissions

BillingPermission[]

Die "billingPermissions" hat die Rolle.

roleName

string

minLength: 1

Der Name der Rolle.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.