Skip to content

Describe Service Revisions

ecs_describe_service_revisions R Documentation

Describes one or more service revisions

Description

Describes one or more service revisions.

A service revision is a version of the service that includes the values for the Amazon ECS resources (for example, task definition) and the environment resources (for example, load balancers, subnets, and security groups). For more information, see Amazon ECS service revisions.

You can't describe a service revision that was created before October 25, 2024.

Usage

ecs_describe_service_revisions(serviceRevisionArns)

Arguments

serviceRevisionArns

[required] The ARN of the service revision.

You can specify a maximum of 20 ARNs.

You can call list_service_deployments to get the ARNs.

Value

A list with the following syntax:

list(
  serviceRevisions = list(
    list(
      serviceRevisionArn = "string",
      serviceArn = "string",
      clusterArn = "string",
      taskDefinition = "string",
      capacityProviderStrategy = list(
        list(
          capacityProvider = "string",
          weight = 123,
          base = 123
        )
      ),
      launchType = "EC2"|"FARGATE"|"EXTERNAL",
      platformVersion = "string",
      platformFamily = "string",
      loadBalancers = list(
        list(
          targetGroupArn = "string",
          loadBalancerName = "string",
          containerName = "string",
          containerPort = 123
        )
      ),
      serviceRegistries = list(
        list(
          registryArn = "string",
          port = 123,
          containerName = "string",
          containerPort = 123
        )
      ),
      networkConfiguration = list(
        awsvpcConfiguration = list(
          subnets = list(
            "string"
          ),
          securityGroups = list(
            "string"
          ),
          assignPublicIp = "ENABLED"|"DISABLED"
        )
      ),
      containerImages = list(
        list(
          containerName = "string",
          imageDigest = "string",
          image = "string"
        )
      ),
      guardDutyEnabled = TRUE|FALSE,
      serviceConnectConfiguration = list(
        enabled = TRUE|FALSE,
        namespace = "string",
        services = list(
          list(
            portName = "string",
            discoveryName = "string",
            clientAliases = list(
              list(
                port = 123,
                dnsName = "string"
              )
            ),
            ingressPortOverride = 123,
            timeout = list(
              idleTimeoutSeconds = 123,
              perRequestTimeoutSeconds = 123
            ),
            tls = list(
              issuerCertificateAuthority = list(
                awsPcaAuthorityArn = "string"
              ),
              kmsKey = "string",
              roleArn = "string"
            )
          )
        ),
        logConfiguration = list(
          logDriver = "json-file"|"syslog"|"journald"|"gelf"|"fluentd"|"awslogs"|"splunk"|"awsfirelens",
          options = list(
            "string"
          ),
          secretOptions = list(
            list(
              name = "string",
              valueFrom = "string"
            )
          )
        )
      ),
      volumeConfigurations = list(
        list(
          name = "string",
          managedEBSVolume = list(
            encrypted = TRUE|FALSE,
            kmsKeyId = "string",
            volumeType = "string",
            sizeInGiB = 123,
            snapshotId = "string",
            iops = 123,
            throughput = 123,
            tagSpecifications = list(
              list(
                resourceType = "volume",
                tags = list(
                  list(
                    key = "string",
                    value = "string"
                  )
                ),
                propagateTags = "TASK_DEFINITION"|"SERVICE"|"NONE"
              )
            ),
            roleArn = "string",
            filesystemType = "ext3"|"ext4"|"xfs"|"ntfs"
          )
        )
      ),
      fargateEphemeralStorage = list(
        kmsKeyId = "string"
      ),
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      vpcLatticeConfigurations = list(
        list(
          roleArn = "string",
          targetGroupArn = "string",
          portName = "string"
        )
      )
    )
  ),
  failures = list(
    list(
      arn = "string",
      reason = "string",
      detail = "string"
    )
  )
)

Request syntax

svc$describe_service_revisions(
  serviceRevisionArns = list(
    "string"
  )
)