/* * Copyright 2010-2018 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 com.amazonaws.services.ec2.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; import com.amazonaws.Request; import com.amazonaws.services.ec2.model.transform.GetPasswordDataRequestMarshaller; /** * Container for the parameters to the {@link com.amazonaws.services.ec2.AmazonEC2#getPasswordData(GetPasswordDataRequest) GetPasswordData operation}. *
* Retrieves the encrypted administrator password for an instance running * Windows. *
*
* The Windows password is generated at boot if the
* EC2Config
service plugin, Ec2SetPassword
,
* is enabled. This usually only happens the first time an AMI is
* launched, and then Ec2SetPassword
is automatically
* disabled. The password is not generated for rebundled AMIs unless
* Ec2SetPassword
is enabled before bundling.
*
* The password is encrypted using the key pair that you specified when * you launched the instance. You must provide the corresponding key pair * file. *
** Password generation and encryption takes a few moments. We recommend * that you wait up to 15 minutes after launching an instance before * trying to retrieve the generated password. *
* * @see com.amazonaws.services.ec2.AmazonEC2#getPasswordData(GetPasswordDataRequest) */ public class GetPasswordDataRequest extends AmazonWebServiceRequest implements Serializable, DryRunSupportedRequest
* Returns a reference to this object so that method calls can be chained together.
*
* @param instanceId The ID of the Windows instance.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public GetPasswordDataRequest withInstanceId(String instanceId) {
this.instanceId = instanceId;
return this;
}
/**
* This method is intended for internal use only.
* Returns the marshaled request configured with additional parameters to
* enable operation dry-run.
*/
@Override
public Request