Role Eligibility Schedules - Get

Service:

Authorization

API-versie:

2020-10-01

Het opgegeven geschiktheidsschema voor rollen ophalen voor een resourcebereik

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleEligibilitySchedules/{roleEligibilityScheduleName}?api-version=2020-10-01

URI-parameters

Name	In	Vereist	Type	Description
roleEligibilityScheduleName	path	True	string	De naam (guid) van het geschiktheidsschema voor rollen om te verkrijgen.
scope	path	True	string	Het bereik van het geschiktheidsschema voor rollen.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	RoleEligibilitySchedule	OK: retourneert informatie over het geschiktheidsschema voor rollen.
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

GetRoleEligibilityScheduleByName

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/providers/Microsoft.Subscription/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleEligibilitySchedules/b1477448-2cc6-4ceb-93b4-54a202a89413?api-version=2020-10-01

Voorbeeldrespons

Statuscode:

200

{
  "properties": {
    "scope": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
    "roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/b24988ac-6180-42a0-ab88-20f7382dd24c",
    "principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "principalType": "User",
    "status": "Provisioned",
    "roleEligibilityScheduleRequestId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/RoleEligibilityScheduleRequests/64caffb6-55c0-4deb-a585-68e948ea1ad6",
    "startDateTime": "2020-09-09T21:33:14.557Z",
    "endDateTime": "2021-09-09T21:32:28.49Z",
    "memberType": "Direct",
    "createdOn": "2020-09-09T21:33:06.3Z",
    "updatedOn": "2020-09-09T22:27:00.513Z",
    "condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
    "conditionVersion": "1.0",
    "expandedProperties": {
      "scope": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
        "displayName": "Pay-As-You-Go",
        "type": "subscription"
      },
      "roleDefinition": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
        "displayName": "Contributor",
        "type": "BuiltInRole"
      },
      "principal": {
        "id": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
        "displayName": "User Account",
        "email": "user@my-tenant.com",
        "type": "User"
      }
    }
  },
  "name": "b1477448-2cc6-4ceb-93b4-54a202a89413",
  "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/RoleEligibilitySchedules/b1477448-2cc6-4ceb-93b4-54a202a89413",
  "type": "Microsoft.Authorization/RoleEligibilitySchedules"
}

Definities

Name	Description
CloudError	Een foutreactie van de service.
CloudErrorBody	Een foutreactie van de service.
ExpandedProperties
MemberType	Lidmaatschapstype van het geschiktheidsschema voor rollen
Principal	Details van de principal
principalType	Het principal-type van de toegewezen principal-id.
RoleDefinition	Details van roldefinitie
RoleEligibilitySchedule	Planning voor geschiktheid van rollen
Scope	Details van het resourcebereik
Status	De status van het geschiktheidsschema voor rollen.

CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	CloudErrorBody	Een foutreactie van de service.

CloudErrorBody

Object

Een foutreactie van de service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

ExpandedProperties

Object

Name	Type	Description
principal	Principal	Details van de principal
roleDefinition	RoleDefinition	Details van roldefinitie
scope	Scope	Details van het resourcebereik

MemberType

Opsomming

Lidmaatschapstype van het geschiktheidsschema voor rollen

Waarde	Description
Inherited
Direct
Group

Principal

Object

Details van de principal

Name	Type	Description
displayName	string	Weergavenaam van de principal
email	string	E-mail-id van de principal
id	string	Id van de principal
type	string	Type principal

principalType

Opsomming

Het principal-type van de toegewezen principal-id.

Waarde	Description
User
Group
ServicePrincipal
ForeignGroup
Device

RoleDefinition

Object

Details van roldefinitie

Name	Type	Description
displayName	string	Weergavenaam van de roldefinitie
id	string	Id van de roldefinitie
type	string	Type roldefinitie

RoleEligibilitySchedule

Object

Planning voor geschiktheid van rollen

Name	Type	Description
id	string	De id van de rol in aanmerking komende planning.
name	string	De naam van het rol geschiktheidsschema.
properties.condition	string	De voorwaarden voor de roltoewijzing. Hiermee worden de resources beperkt waaraan deze kan worden toegewezen. bijvoorbeeld: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'
properties.conditionVersion	string	Versie van de voorwaarde. Momenteel geaccepteerde waarde is '2.0'
properties.createdOn	string (date-time)	Datum/tijd waarop het geschiktheidsschema voor rollen is gemaakt
properties.endDateTime	string (date-time)	Einddatum/tijd wanneer het geschiktheidsschema voor rollen wordt beëindigd
properties.expandedProperties	ExpandedProperties	Aanvullende eigenschappen van principal, bereik en roldefinitie
properties.memberType	MemberType	Lidmaatschapstype van het geschiktheidsschema voor rollen
properties.principalId	string	De principal-id.
properties.principalType	principalType	Het principal-type van de toegewezen principal-id.
properties.roleDefinitionId	string	De id van de roldefinitie.
properties.roleEligibilityScheduleRequestId	string	De id van roleEligibilityScheduleRequest die wordt gebruikt om deze roleAssignmentSchedule te maken
properties.scope	string	Het bereik van het geschiktheidsschema voor rollen.
properties.startDateTime	string (date-time)	Begindatum/tijd wanneer de rol in aanmerking komt
properties.status	Status	De status van het geschiktheidsschema voor rollen.
properties.updatedOn	string (date-time)	Datum/tijd waarop het geschiktheidsschema voor rollen is gewijzigd
type	string	Het type geschiktheidsplanning voor rollen.

Scope

Object

Details van het resourcebereik

Name	Type	Description
displayName	string	Weergavenaam van de resource
id	string	Bereik-id van de resource
type	string	Type resource

Status

Opsomming

De status van het geschiktheidsschema voor rollen.

Waarde	Description
Accepted
PendingEvaluation
Granted
Denied
PendingProvisioning
Provisioned
PendingRevocation
Revoked
Canceled
Failed
PendingApprovalProvisioning
PendingApproval
FailedAsResourceIsLocked
PendingAdminDecision
AdminApproved
AdminDenied
TimedOut
ProvisioningStarted
Invalid
PendingScheduleCreation
ScheduleCreated
PendingExternalProvisioning