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"|"MANAGED_INSTANCES",
      platformVersion = "string",
      platformFamily = "string",
      loadBalancers = list(
        list(
          targetGroupArn = "string",
          loadBalancerName = "string",
          containerName = "string",
          containerPort = 123,
          advancedConfiguration = list(
            alternateTargetGroupArn = "string",
            productionListenerRule = "string",
            testListenerRule = "string",
            roleArn = "string"
          )
        )
      ),
      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",
                testTrafficRules = list(
                  header = list(
                    name = "string",
                    value = list(
                      exact = "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"
            )
          )
        ),
        accessLogConfiguration = list(
          format = "TEXT"|"JSON",
          includeQueryParameters = "DISABLED"|"ENABLED"
        )
      ),
      volumeConfigurations = list(
        list(
          name = "string",
          managedEBSVolume = list(
            encrypted = TRUE|FALSE,
            kmsKeyId = "string",
            volumeType = "string",
            sizeInGiB = 123,
            snapshotId = "string",
            volumeInitializationRate = 123,
            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"
        )
      ),
      resolvedConfiguration = list(
        loadBalancers = list(
          list(
            targetGroupArn = "string",
            productionListenerRule = "string"
          )
        )
      ),
      ecsManagedResources = list(
        ingressPaths = list(
          list(
            accessType = "PUBLIC"|"PRIVATE",
            endpoint = "string",
            loadBalancer = list(
              arn = "string",
              status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
              statusReason = "string",
              updatedAt = as.POSIXct(
                "2015-01-01"
              ),
              scheme = "string",
              subnetIds = list(
                "string"
              ),
              securityGroupIds = list(
                "string"
              )
            ),
            loadBalancerSecurityGroups = list(
              list(
                arn = "string",
                status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
                statusReason = "string",
                updatedAt = as.POSIXct(
                  "2015-01-01"
                )
              )
            ),
            certificate = list(
              arn = "string",
              status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
              statusReason = "string",
              updatedAt = as.POSIXct(
                "2015-01-01"
              ),
              domainName = "string"
            ),
            listener = list(
              arn = "string",
              status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
              statusReason = "string",
              updatedAt = as.POSIXct(
                "2015-01-01"
              )
            ),
            rule = list(
              arn = "string",
              status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
              statusReason = "string",
              updatedAt = as.POSIXct(
                "2015-01-01"
              )
            ),
            targetGroups = list(
              list(
                arn = "string",
                status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
                statusReason = "string",
                updatedAt = as.POSIXct(
                  "2015-01-01"
                ),
                healthCheckPath = "string",
                healthCheckPort = 123,
                port = 123
              )
            )
          )
        ),
        autoScaling = list(
          scalableTarget = list(
            arn = "string",
            status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
            statusReason = "string",
            updatedAt = as.POSIXct(
              "2015-01-01"
            ),
            minCapacity = 123,
            maxCapacity = 123
          ),
          applicationAutoScalingPolicies = list(
            list(
              arn = "string",
              status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
              statusReason = "string",
              updatedAt = as.POSIXct(
                "2015-01-01"
              ),
              policyType = "string",
              targetValue = 123.0,
              metric = "string"
            )
          )
        ),
        metricAlarms = list(
          list(
            arn = "string",
            status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
            statusReason = "string",
            updatedAt = as.POSIXct(
              "2015-01-01"
            )
          )
        ),
        serviceSecurityGroups = list(
          list(
            arn = "string",
            status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
            statusReason = "string",
            updatedAt = as.POSIXct(
              "2015-01-01"
            )
          )
        ),
        logGroups = list(
          list(
            arn = "string",
            status = "PROVISIONING"|"ACTIVE"|"DEPROVISIONING"|"DELETED"|"FAILED",
            statusReason = "string",
            updatedAt = as.POSIXct(
              "2015-01-01"
            ),
            logGroupName = "string"
          )
        )
      )
    )
  ),
  failures = list(
    list(
      arn = "string",
      reason = "string",
      detail = "string"
    )
  )
)

Request syntax

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