StudioComponent
A studio component represents a network resource to be used by a studio's users and workflows. A typical studio contains studio components for each of the following: render farm, Active Directory, licensing, and file system.
Access to a studio component is managed by specifying security groups for the resource, as well as its endpoint.
A studio component also has a set of initialization scripts that are returned by
GetLaunchProfileInitialization
. These initialization scripts run on
streaming sessions when they start. They provide users with flexibility in controlling
how the studio resources are configured on a streaming session.
Contents
- arn
-
The Amazon Resource Name (ARN) that is assigned to a studio resource and uniquely identifies it. ARNs are unique across all Regions.
Type: String
Required: No
- configuration
-
The configuration of the studio component, based on component type.
Type: StudioComponentConfiguration object
Note: This object is a Union. Only one member of this object can be specified or returned.
Required: No
- createdAt
-
The ISO timestamp in seconds for when the resource was created.
Type: Timestamp
Required: No
- createdBy
-
The user ID of the user that created the studio component.
Type: String
Required: No
- description
-
A human-readable description for the studio component resource.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Required: No
- ec2SecurityGroupIds
-
The EC2 security groups that control access to the studio component.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 30 items.
Required: No
- initializationScripts
-
Initialization scripts for studio components.
Type: Array of StudioComponentInitializationScript objects
Required: No
- name
-
A friendly name for the studio component resource.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 64.
Required: No
- runtimeRoleArn
-
An IAM role attached to a Studio Component that gives the studio component access to AWS resources at anytime while the instance is running.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Required: No
- scriptParameters
-
Parameters for the studio component scripts.
Type: Array of ScriptParameterKeyValue objects
Array Members: Minimum number of 0 items. Maximum number of 30 items.
Required: No
- secureInitializationRoleArn
-
An IAM role attached to Studio Component when the system initialization script runs which give the studio component access to AWS resources when the system initialization script runs.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Required: No
- state
-
The current state.
Type: String
Valid Values:
CREATE_IN_PROGRESS | READY | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | DELETED | DELETE_FAILED | CREATE_FAILED | UPDATE_FAILED
Required: No
- statusCode
-
The status code.
Type: String
Valid Values:
ACTIVE_DIRECTORY_ALREADY_EXISTS | STUDIO_COMPONENT_CREATED | STUDIO_COMPONENT_UPDATED | STUDIO_COMPONENT_DELETED | ENCRYPTION_KEY_ACCESS_DENIED | ENCRYPTION_KEY_NOT_FOUND | STUDIO_COMPONENT_CREATE_IN_PROGRESS | STUDIO_COMPONENT_UPDATE_IN_PROGRESS | STUDIO_COMPONENT_DELETE_IN_PROGRESS | INTERNAL_ERROR
Required: No
- statusMessage
-
The status message for the studio component.
Type: String
Required: No
- studioComponentId
-
The unique identifier for a studio component resource.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 22.
Pattern:
^[a-zA-Z0-9-_]*$
Required: No
- subtype
-
The specific subtype of a studio component.
Type: String
Valid Values:
AWS_MANAGED_MICROSOFT_AD | AMAZON_FSX_FOR_WINDOWS | AMAZON_FSX_FOR_LUSTRE | CUSTOM
Required: No
-
A collection of labels, in the form of key-value pairs, that apply to this resource.
Type: String to string map
Required: No
- type
-
The type of the studio component.
Type: String
Valid Values:
ACTIVE_DIRECTORY | SHARED_FILE_SYSTEM | COMPUTE_FARM | LICENSE_SERVICE | CUSTOM
Required: No
- updatedAt
-
The ISO timestamp in seconds for when the resource was updated.
Type: Timestamp
Required: No
- updatedBy
-
The user ID of the user that most recently updated the resource.
Type: String
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: