Skip to content

IAM  >  Operations  >  update_server_certificate

update_server_certificate

Operation

update_server_certificate async

update_server_certificate(input: UpdateServerCertificateInput, plugins: list[Plugin] | None = None) -> UpdateServerCertificateOutput

Updates the name and/or the path of the specified server certificate stored in IAM.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic also includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

Warning

You should understand the implications of changing a server certificate's path or name. For more information, see Renaming a server certificate in the IAM User Guide.

Note: The person making the request (the principal), must have permission to change the server certificate with the old name and the new name. For example, to change the certificate named ProductionCert to ProdCert, the principal must have a policy that allows them to update both certificates. If the principal has permission to update the ProductionCert group, but not the ProdCert certificate, then the update fails. For more information about permissions, see Access management in the IAM User Guide.

Parameters:

Name Type Description Default
input UpdateServerCertificateInput

An instance of UpdateServerCertificateInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
UpdateServerCertificateOutput

An instance of UpdateServerCertificateOutput.

Input

UpdateServerCertificateInput dataclass

Bases: _SerdeShape

Dataclass for UpdateServerCertificateInput structure.

Attributes

new_path class-attribute instance-attribute
new_path: str | None = ...

The new path for the server certificate. Include this only if you are updating the server certificate's path.

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (!) through the DEL character (), including most punctuation characters, digits, and upper and lowercased letters.

new_server_certificate_name class-attribute instance-attribute
new_server_certificate_name: str | None = ...

The new name for the server certificate. Include this only if you are updating the server certificate's name. The name of the certificate cannot contain any spaces.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

server_certificate_name class-attribute instance-attribute
server_certificate_name: str | None = ...

The name of the server certificate that you want to update.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Output

UpdateServerCertificateOutput dataclass

Bases: _SerdeShape

Dataclass for UpdateServerCertificateOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.