
software.amazon.awssdk.services.sagemaker.model.UpdateDomainRequest Maven / Gradle / Ivy
Show all versions of sagemaker Show documentation
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package software.amazon.awssdk.services.sagemaker.model;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
import java.util.function.Function;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.awscore.AwsRequestOverrideConfiguration;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.ListTrait;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.core.util.DefaultSdkAutoConstructList;
import software.amazon.awssdk.core.util.SdkAutoConstructList;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;
/**
*/
@Generated("software.amazon.awssdk:codegen")
public final class UpdateDomainRequest extends SageMakerRequest implements
ToCopyableBuilder {
private static final SdkField DOMAIN_ID_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("DomainId").getter(getter(UpdateDomainRequest::domainId)).setter(setter(Builder::domainId))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("DomainId").build()).build();
private static final SdkField DEFAULT_USER_SETTINGS_FIELD = SdkField
. builder(MarshallingType.SDK_POJO).memberName("DefaultUserSettings")
.getter(getter(UpdateDomainRequest::defaultUserSettings)).setter(setter(Builder::defaultUserSettings))
.constructor(UserSettings::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("DefaultUserSettings").build())
.build();
private static final SdkField DOMAIN_SETTINGS_FOR_UPDATE_FIELD = SdkField
. builder(MarshallingType.SDK_POJO).memberName("DomainSettingsForUpdate")
.getter(getter(UpdateDomainRequest::domainSettingsForUpdate)).setter(setter(Builder::domainSettingsForUpdate))
.constructor(DomainSettingsForUpdate::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("DomainSettingsForUpdate").build())
.build();
private static final SdkField APP_SECURITY_GROUP_MANAGEMENT_FIELD = SdkField
. builder(MarshallingType.STRING)
.memberName("AppSecurityGroupManagement")
.getter(getter(UpdateDomainRequest::appSecurityGroupManagementAsString))
.setter(setter(Builder::appSecurityGroupManagement))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("AppSecurityGroupManagement").build())
.build();
private static final SdkField DEFAULT_SPACE_SETTINGS_FIELD = SdkField
. builder(MarshallingType.SDK_POJO).memberName("DefaultSpaceSettings")
.getter(getter(UpdateDomainRequest::defaultSpaceSettings)).setter(setter(Builder::defaultSpaceSettings))
.constructor(DefaultSpaceSettings::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("DefaultSpaceSettings").build())
.build();
private static final SdkField> SUBNET_IDS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("SubnetIds")
.getter(getter(UpdateDomainRequest::subnetIds))
.setter(setter(Builder::subnetIds))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("SubnetIds").build(),
ListTrait
.builder()
.memberLocationName(null)
.memberFieldInfo(
SdkField. builder(MarshallingType.STRING)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("member").build()).build()).build()).build();
private static final SdkField APP_NETWORK_ACCESS_TYPE_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("AppNetworkAccessType").getter(getter(UpdateDomainRequest::appNetworkAccessTypeAsString))
.setter(setter(Builder::appNetworkAccessType))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("AppNetworkAccessType").build())
.build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(DOMAIN_ID_FIELD,
DEFAULT_USER_SETTINGS_FIELD, DOMAIN_SETTINGS_FOR_UPDATE_FIELD, APP_SECURITY_GROUP_MANAGEMENT_FIELD,
DEFAULT_SPACE_SETTINGS_FIELD, SUBNET_IDS_FIELD, APP_NETWORK_ACCESS_TYPE_FIELD));
private final String domainId;
private final UserSettings defaultUserSettings;
private final DomainSettingsForUpdate domainSettingsForUpdate;
private final String appSecurityGroupManagement;
private final DefaultSpaceSettings defaultSpaceSettings;
private final List subnetIds;
private final String appNetworkAccessType;
private UpdateDomainRequest(BuilderImpl builder) {
super(builder);
this.domainId = builder.domainId;
this.defaultUserSettings = builder.defaultUserSettings;
this.domainSettingsForUpdate = builder.domainSettingsForUpdate;
this.appSecurityGroupManagement = builder.appSecurityGroupManagement;
this.defaultSpaceSettings = builder.defaultSpaceSettings;
this.subnetIds = builder.subnetIds;
this.appNetworkAccessType = builder.appNetworkAccessType;
}
/**
*
* The ID of the domain to be updated.
*
*
* @return The ID of the domain to be updated.
*/
public final String domainId() {
return domainId;
}
/**
*
* A collection of settings.
*
*
* @return A collection of settings.
*/
public final UserSettings defaultUserSettings() {
return defaultUserSettings;
}
/**
*
* A collection of DomainSettings
configuration values to update.
*
*
* @return A collection of DomainSettings
configuration values to update.
*/
public final DomainSettingsForUpdate domainSettingsForUpdate() {
return domainSettingsForUpdate;
}
/**
*
* The entity that creates and manages the required security groups for inter-app communication in
* VPCOnly
mode. Required when CreateDomain.AppNetworkAccessType
is VPCOnly
* and DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided. If setting up
* the domain for use with RStudio, this value must be set to Service
.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #appSecurityGroupManagement} will return {@link AppSecurityGroupManagement#UNKNOWN_TO_SDK_VERSION}. The
* raw value returned by the service is available from {@link #appSecurityGroupManagementAsString}.
*
*
* @return The entity that creates and manages the required security groups for inter-app communication in
* VPCOnly
mode. Required when CreateDomain.AppNetworkAccessType
is
* VPCOnly
and
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided. If setting
* up the domain for use with RStudio, this value must be set to Service
.
* @see AppSecurityGroupManagement
*/
public final AppSecurityGroupManagement appSecurityGroupManagement() {
return AppSecurityGroupManagement.fromValue(appSecurityGroupManagement);
}
/**
*
* The entity that creates and manages the required security groups for inter-app communication in
* VPCOnly
mode. Required when CreateDomain.AppNetworkAccessType
is VPCOnly
* and DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided. If setting up
* the domain for use with RStudio, this value must be set to Service
.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #appSecurityGroupManagement} will return {@link AppSecurityGroupManagement#UNKNOWN_TO_SDK_VERSION}. The
* raw value returned by the service is available from {@link #appSecurityGroupManagementAsString}.
*
*
* @return The entity that creates and manages the required security groups for inter-app communication in
* VPCOnly
mode. Required when CreateDomain.AppNetworkAccessType
is
* VPCOnly
and
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided. If setting
* up the domain for use with RStudio, this value must be set to Service
.
* @see AppSecurityGroupManagement
*/
public final String appSecurityGroupManagementAsString() {
return appSecurityGroupManagement;
}
/**
*
* The default settings used to create a space within the domain.
*
*
* @return The default settings used to create a space within the domain.
*/
public final DefaultSpaceSettings defaultSpaceSettings() {
return defaultSpaceSettings;
}
/**
* For responses, this returns true if the service returned a value for the SubnetIds property. This DOES NOT check
* that the value is non-empty (for which, you should check the {@code isEmpty()} method on the property). This is
* useful because the SDK will never return a null collection or map, but you may need to differentiate between the
* service returning nothing (or null) and the service returning an empty collection or map. For requests, this
* returns true if a value for the property was specified in the request builder, and false if a value was not
* specified.
*/
public final boolean hasSubnetIds() {
return subnetIds != null && !(subnetIds instanceof SdkAutoConstructList);
}
/**
*
* The VPC subnets that Studio uses for communication.
*
*
* If removing subnets, ensure there are no apps in the InService
, Pending
, or
* Deleting
state.
*
*
* Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
*
*
* This method will never return null. If you would like to know whether the service returned this field (so that
* you can differentiate between null and empty), you can use the {@link #hasSubnetIds} method.
*
*
* @return The VPC subnets that Studio uses for communication.
*
* If removing subnets, ensure there are no apps in the InService
, Pending
, or
* Deleting
state.
*/
public final List subnetIds() {
return subnetIds;
}
/**
*
* Specifies the VPC used for non-EFS traffic.
*
*
* -
*
* PublicInternetOnly
- Non-EFS traffic is through a VPC managed by Amazon SageMaker, which allows
* direct internet access.
*
*
* -
*
* VpcOnly
- All Studio traffic is through the specified VPC and subnets.
*
*
*
*
* This configuration can only be modified if there are no apps in the InService
, Pending
,
* or Deleting
state. The configuration cannot be updated if
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is already set or
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided as part of the same
* request.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #appNetworkAccessType} will return {@link AppNetworkAccessType#UNKNOWN_TO_SDK_VERSION}. The raw value
* returned by the service is available from {@link #appNetworkAccessTypeAsString}.
*
*
* @return Specifies the VPC used for non-EFS traffic.
*
* -
*
* PublicInternetOnly
- Non-EFS traffic is through a VPC managed by Amazon SageMaker, which
* allows direct internet access.
*
*
* -
*
* VpcOnly
- All Studio traffic is through the specified VPC and subnets.
*
*
*
*
* This configuration can only be modified if there are no apps in the InService
,
* Pending
, or Deleting
state. The configuration cannot be updated if
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is already set or
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided as part of
* the same request.
* @see AppNetworkAccessType
*/
public final AppNetworkAccessType appNetworkAccessType() {
return AppNetworkAccessType.fromValue(appNetworkAccessType);
}
/**
*
* Specifies the VPC used for non-EFS traffic.
*
*
* -
*
* PublicInternetOnly
- Non-EFS traffic is through a VPC managed by Amazon SageMaker, which allows
* direct internet access.
*
*
* -
*
* VpcOnly
- All Studio traffic is through the specified VPC and subnets.
*
*
*
*
* This configuration can only be modified if there are no apps in the InService
, Pending
,
* or Deleting
state. The configuration cannot be updated if
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is already set or
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided as part of the same
* request.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #appNetworkAccessType} will return {@link AppNetworkAccessType#UNKNOWN_TO_SDK_VERSION}. The raw value
* returned by the service is available from {@link #appNetworkAccessTypeAsString}.
*
*
* @return Specifies the VPC used for non-EFS traffic.
*
* -
*
* PublicInternetOnly
- Non-EFS traffic is through a VPC managed by Amazon SageMaker, which
* allows direct internet access.
*
*
* -
*
* VpcOnly
- All Studio traffic is through the specified VPC and subnets.
*
*
*
*
* This configuration can only be modified if there are no apps in the InService
,
* Pending
, or Deleting
state. The configuration cannot be updated if
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is already set or
* DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided as part of
* the same request.
* @see AppNetworkAccessType
*/
public final String appNetworkAccessTypeAsString() {
return appNetworkAccessType;
}
@Override
public Builder toBuilder() {
return new BuilderImpl(this);
}
public static Builder builder() {
return new BuilderImpl();
}
public static Class extends Builder> serializableBuilderClass() {
return BuilderImpl.class;
}
@Override
public final int hashCode() {
int hashCode = 1;
hashCode = 31 * hashCode + super.hashCode();
hashCode = 31 * hashCode + Objects.hashCode(domainId());
hashCode = 31 * hashCode + Objects.hashCode(defaultUserSettings());
hashCode = 31 * hashCode + Objects.hashCode(domainSettingsForUpdate());
hashCode = 31 * hashCode + Objects.hashCode(appSecurityGroupManagementAsString());
hashCode = 31 * hashCode + Objects.hashCode(defaultSpaceSettings());
hashCode = 31 * hashCode + Objects.hashCode(hasSubnetIds() ? subnetIds() : null);
hashCode = 31 * hashCode + Objects.hashCode(appNetworkAccessTypeAsString());
return hashCode;
}
@Override
public final boolean equals(Object obj) {
return super.equals(obj) && equalsBySdkFields(obj);
}
@Override
public final boolean equalsBySdkFields(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof UpdateDomainRequest)) {
return false;
}
UpdateDomainRequest other = (UpdateDomainRequest) obj;
return Objects.equals(domainId(), other.domainId()) && Objects.equals(defaultUserSettings(), other.defaultUserSettings())
&& Objects.equals(domainSettingsForUpdate(), other.domainSettingsForUpdate())
&& Objects.equals(appSecurityGroupManagementAsString(), other.appSecurityGroupManagementAsString())
&& Objects.equals(defaultSpaceSettings(), other.defaultSpaceSettings()) && hasSubnetIds() == other.hasSubnetIds()
&& Objects.equals(subnetIds(), other.subnetIds())
&& Objects.equals(appNetworkAccessTypeAsString(), other.appNetworkAccessTypeAsString());
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*/
@Override
public final String toString() {
return ToString.builder("UpdateDomainRequest").add("DomainId", domainId())
.add("DefaultUserSettings", defaultUserSettings()).add("DomainSettingsForUpdate", domainSettingsForUpdate())
.add("AppSecurityGroupManagement", appSecurityGroupManagementAsString())
.add("DefaultSpaceSettings", defaultSpaceSettings()).add("SubnetIds", hasSubnetIds() ? subnetIds() : null)
.add("AppNetworkAccessType", appNetworkAccessTypeAsString()).build();
}
public final Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "DomainId":
return Optional.ofNullable(clazz.cast(domainId()));
case "DefaultUserSettings":
return Optional.ofNullable(clazz.cast(defaultUserSettings()));
case "DomainSettingsForUpdate":
return Optional.ofNullable(clazz.cast(domainSettingsForUpdate()));
case "AppSecurityGroupManagement":
return Optional.ofNullable(clazz.cast(appSecurityGroupManagementAsString()));
case "DefaultSpaceSettings":
return Optional.ofNullable(clazz.cast(defaultSpaceSettings()));
case "SubnetIds":
return Optional.ofNullable(clazz.cast(subnetIds()));
case "AppNetworkAccessType":
return Optional.ofNullable(clazz.cast(appNetworkAccessTypeAsString()));
default:
return Optional.empty();
}
}
@Override
public final List> sdkFields() {
return SDK_FIELDS;
}
private static Function