Role Assignment Schedule Requests - Create
Cria um pedido de agendamento de atribuição de funções.
PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignmentScheduleRequests/{roleAssignmentScheduleRequestName}?api-version=2020-10-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
role
|
path | True |
string |
Um GUID para a atribuição de função a criar. O nome tem de ser exclusivo e diferente para cada atribuição de função. |
scope
|
path | True |
string |
O âmbito do pedido de agendamento de atribuição de funções a criar. O âmbito pode ser qualquer instância de recurso REST. Por exemplo, utilize "/subscriptions/{subscription-id}/" para uma subscrição, "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}" para um grupo de recursos e "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name}" para um recurso. |
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
properties.principalId | True |
string |
O ID principal. |
properties.requestType | True |
O tipo do pedido de agendamento de atribuição de função. Por exemplo: SelfActivate, AdminAssign, etc. |
|
properties.roleDefinitionId | True |
string |
O ID da definição de função. |
properties.condition |
string |
As condições na atribuição de função. Isto limita os recursos aos quais pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container' |
|
properties.conditionVersion |
string |
Versão da condição. O valor atualmente aceite é "2.0" |
|
properties.justification |
string |
Justificação para a atribuição de função |
|
properties.linkedRoleEligibilityScheduleId |
string |
O ID de agenda da elegibilidade da função associada – para ativar uma elegibilidade. |
|
properties.scheduleInfo |
Agendar informações da agenda de atribuição de funções |
||
properties.targetRoleAssignmentScheduleId |
string |
O ID da agenda de atribuição de função resultante ou o ID do agendamento da atribuição de funções que está a ser atualizado |
|
properties.targetRoleAssignmentScheduleInstanceId |
string |
O ID da instância da agenda de atribuição de funções a ser atualizado |
|
properties.ticketInfo |
Informações do Pedido de Suporte da atribuição de função |
Respostas
Name | Tipo | Description |
---|---|---|
201 Created |
Criado – devolve informações sobre a atribuição de função. |
|
Other Status Codes |
Resposta de erro que descreve o motivo pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
PutRoleAssignmentScheduleRequest
Pedido de amostra
PUT https://management.azure.com/providers/Microsoft.Subscription/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleAssignmentScheduleRequests/fea7a502-9a96-4806-a26f-eee560e52045?api-version=2020-10-01
{
"properties": {
"principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
"roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
"requestType": "SelfActivate",
"linkedRoleEligibilityScheduleId": "b1477448-2cc6-4ceb-93b4-54a202a89413",
"scheduleInfo": {
"startDateTime": "2020-09-09T21:35:27.91Z",
"expiration": {
"type": "AfterDuration",
"endDateTime": null,
"duration": "PT8H"
}
},
"condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
"conditionVersion": "1.0"
}
}
Resposta da amostra
{
"properties": {
"targetRoleAssignmentScheduleId": "c9e264ff-3133-4776-a81a-ebc7c33c8ec6",
"targetRoleAssignmentScheduleInstanceId": null,
"scope": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
"roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
"principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
"principalType": "User",
"requestType": "SelfActivate",
"status": "Provisioned",
"approvalId": null,
"scheduleInfo": {
"startDateTime": "2020-09-09T21:35:27.91Z",
"expiration": {
"type": "AfterDuration",
"endDateTime": null,
"duration": "PT8H"
}
},
"ticketInfo": {
"ticketNumber": null,
"ticketSystem": null
},
"justification": null,
"requestorId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
"createdOn": "2020-09-09T21:35:27.91Z",
"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": "fea7a502-9a96-4806-a26f-eee560e52045",
"id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/RoleAssignmentScheduleRequests/fea7a502-9a96-4806-a26f-eee560e52045",
"type": "Microsoft.Authorization/RoleAssignmentScheduleRequests"
}
Definições
Name | Description |
---|---|
Cloud |
Uma resposta de erro do serviço. |
Cloud |
Uma resposta de erro do serviço. |
Expanded |
|
Expiration |
Expiração da agenda de atribuição de funções |
Principal |
Detalhes do principal |
principal |
O tipo principal do ID principal atribuído. |
Request |
O tipo do pedido de agendamento de atribuição de função. Por exemplo: SelfActivate, AdminAssign, etc. |
Role |
Pedido de agendamento de Atribuição de Função |
Role |
Detalhes da definição de função |
Schedule |
Agendar informações da agenda de atribuição de funções |
Scope |
Detalhes do âmbito do recurso |
Status |
O estado do pedido de agendamento de atribuição de funções. |
Ticket |
Informações do Pedido de Suporte da atribuição de função |
Type |
Tipo de expiração da agenda de atribuição de funções |
CloudError
Uma resposta de erro do serviço.
Name | Tipo | Description |
---|---|---|
error |
Uma resposta de erro do serviço. |
CloudErrorBody
Uma resposta de erro do serviço.
Name | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente. |
message |
string |
Uma mensagem que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador. |
ExpandedProperties
Name | Tipo | Description |
---|---|---|
principal |
Detalhes do principal |
|
roleDefinition |
Detalhes da definição de função |
|
scope |
Detalhes do âmbito do recurso |
Expiration
Expiração da agenda de atribuição de funções
Name | Tipo | Description |
---|---|---|
duration |
string |
Duração da agenda de atribuição de funções no TimeSpan. |
endDateTime |
string |
End DateTime da agenda de atribuição de funções. |
type |
Tipo de expiração da agenda de atribuição de funções |
Principal
Detalhes do principal
Name | Tipo | Description |
---|---|---|
displayName |
string |
Nome a apresentar do principal |
string |
Email ID do principal |
|
id |
string |
ID do principal |
type |
string |
Tipo de principal |
principalType
O tipo principal do ID principal atribuído.
Name | Tipo | Description |
---|---|---|
Device |
string |
|
ForeignGroup |
string |
|
Group |
string |
|
ServicePrincipal |
string |
|
User |
string |
RequestType
O tipo do pedido de agendamento de atribuição de função. Por exemplo: SelfActivate, AdminAssign, etc.
Name | Tipo | Description |
---|---|---|
AdminAssign |
string |
|
AdminExtend |
string |
|
AdminRemove |
string |
|
AdminRenew |
string |
|
AdminUpdate |
string |
|
SelfActivate |
string |
|
SelfDeactivate |
string |
|
SelfExtend |
string |
|
SelfRenew |
string |
RoleAssignmentScheduleRequest
Pedido de agendamento de Atribuição de Função
Name | Tipo | Description |
---|---|---|
id |
string |
O ID do pedido de agendamento de atribuição de funções. |
name |
string |
O nome do pedido de agendamento de atribuição de função. |
properties.approvalId |
string |
O approvalId do pedido de agendamento de atribuição de funções. |
properties.condition |
string |
As condições na atribuição de função. Isto limita os recursos aos quais pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container' |
properties.conditionVersion |
string |
Versão da condição. O valor atualmente aceite é "2.0" |
properties.createdOn |
string |
DateTime quando o pedido de agendamento de atribuição de funções foi criado |
properties.expandedProperties |
Propriedades adicionais do principal, âmbito e definição de função |
|
properties.justification |
string |
Justificação para a atribuição de função |
properties.linkedRoleEligibilityScheduleId |
string |
O ID de agenda da elegibilidade da função associada – para ativar uma elegibilidade. |
properties.principalId |
string |
O ID principal. |
properties.principalType |
O tipo principal do ID principal atribuído. |
|
properties.requestType |
O tipo do pedido de agendamento de atribuição de função. Por exemplo: SelfActivate, AdminAssign, etc. |
|
properties.requestorId |
string |
ID do utilizador que criou este pedido |
properties.roleDefinitionId |
string |
O ID da definição de função. |
properties.scheduleInfo |
Agendar informações da agenda de atribuição de funções |
|
properties.scope |
string |
O âmbito do pedido de agendamento de atribuição de funções. |
properties.status |
O estado do pedido de agendamento de atribuição de funções. |
|
properties.targetRoleAssignmentScheduleId |
string |
O ID da agenda de atribuição de função resultante ou o ID do agendamento da atribuição de funções que está a ser atualizado |
properties.targetRoleAssignmentScheduleInstanceId |
string |
O ID da instância da agenda de atribuição de funções a ser atualizado |
properties.ticketInfo |
Informações do Pedido de Suporte da atribuição de função |
|
type |
string |
O tipo de pedido de agendamento de atribuição de funções. |
RoleDefinition
Detalhes da definição de função
Name | Tipo | Description |
---|---|---|
displayName |
string |
Nome a apresentar da definição de função |
id |
string |
ID da definição de função |
type |
string |
Tipo da definição de função |
ScheduleInfo
Agendar informações da agenda de atribuição de funções
Name | Tipo | Description |
---|---|---|
expiration |
Expiração da agenda de atribuição de funções |
|
startDateTime |
string |
Start DateTime da agenda de atribuição de funções. |
Scope
Detalhes do âmbito do recurso
Name | Tipo | Description |
---|---|---|
displayName |
string |
Nome a apresentar do recurso |
id |
string |
ID de âmbito do recurso |
type |
string |
Tipo do recurso |
Status
O estado do pedido de agendamento de atribuição de funções.
Name | Tipo | Description |
---|---|---|
Accepted |
string |
|
AdminApproved |
string |
|
AdminDenied |
string |
|
Canceled |
string |
|
Denied |
string |
|
Failed |
string |
|
FailedAsResourceIsLocked |
string |
|
Granted |
string |
|
Invalid |
string |
|
PendingAdminDecision |
string |
|
PendingApproval |
string |
|
PendingApprovalProvisioning |
string |
|
PendingEvaluation |
string |
|
PendingExternalProvisioning |
string |
|
PendingProvisioning |
string |
|
PendingRevocation |
string |
|
PendingScheduleCreation |
string |
|
Provisioned |
string |
|
ProvisioningStarted |
string |
|
Revoked |
string |
|
ScheduleCreated |
string |
|
TimedOut |
string |
TicketInfo
Informações do Pedido de Suporte da atribuição de função
Name | Tipo | Description |
---|---|---|
ticketNumber |
string |
Número de pedido para a atribuição de função |
ticketSystem |
string |
Nome do sistema de pedidos para a atribuição de função |
Type
Tipo de expiração da agenda de atribuição de funções
Name | Tipo | Description |
---|---|---|
AfterDateTime |
string |
|
AfterDuration |
string |
|
NoExpiration |
string |