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
roleAssignmentScheduleRequestName
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

RequestType

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

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

TicketInfo

Informações do Pedido de Suporte da atribuição de função

Respostas

Name Tipo Description
201 Created

RoleAssignmentScheduleRequest

Criado – devolve informações sobre a atribuição de função.

Other Status Codes

CloudError

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
CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

ExpandedProperties
Expiration

Expiração da agenda de atribuição de funções

Principal

Detalhes do principal

principalType

O tipo principal do ID principal atribuído.

RequestType

O tipo do pedido de agendamento de atribuição de função. Por exemplo: SelfActivate, AdminAssign, etc.

RoleAssignmentScheduleRequest

Pedido de agendamento de Atribuição de Função

RoleDefinition

Detalhes da definição de função

ScheduleInfo

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.

TicketInfo

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

CloudErrorBody

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

Principal

Detalhes do principal

roleDefinition

RoleDefinition

Detalhes da definição de função

scope

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

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

email

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

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

principalType

O tipo principal do ID principal atribuído.

properties.requestType

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

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

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

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

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