AssociateMemberToJob
Assigns a job membership level to a member
Request Syntax
PUT /2023-10-12/farms/farmId
/queues/queueId
/jobs/jobId
/members/principalId
HTTP/1.1
Content-type: application/json
{
"identityStoreId": "string
",
"membershipLevel": "string
",
"principalType": "string
"
}
URI Request Parameters
The request uses the following URI parameters.
- farmId
-
The farm ID of the job to associate with the member.
Pattern:
farm-[0-9a-f]{32}
Required: Yes
- jobId
-
The job ID to associate with the member.
Pattern:
job-[0-9a-f]{32}
Required: Yes
- principalId
-
The member's principal ID to associate with the job.
Length Constraints: Minimum length of 1. Maximum length of 47.
Pattern:
([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}
Required: Yes
- queueId
-
The queue ID to associate to the member.
Pattern:
queue-[0-9a-f]{32}
Required: Yes
Request Body
The request accepts the following data in JSON format.
- identityStoreId
-
The member's identity store ID to associate with the job.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 36.
Pattern:
d-[0-9a-f]{10}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
Required: Yes
- membershipLevel
-
The principal's membership level for the associated job.
Type: String
Valid Values:
VIEWER | CONTRIBUTOR | OWNER | MANAGER
Required: Yes
- principalType
-
The member's principal type to associate with the job.
Type: String
Valid Values:
USER | GROUP
Required: Yes
Response Syntax
HTTP/1.1 200
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You don't have permission to perform the action.
HTTP Status Code: 403
- InternalServerErrorException
-
Deadline Cloud can't process your request right now. Try again later.
HTTP Status Code: 500
- ResourceNotFoundException
-
The requested resource can't be found.
HTTP Status Code: 404
- ServiceQuotaExceededException
-
You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account.
HTTP Status Code: 402
- ThrottlingException
-
Your request exceeded a request rate quota.
HTTP Status Code: 429
- ValidationException
-
The request isn't valid. This can occur if your request contains malformed JSON or unsupported characters.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: